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INTRODUCTION 
This manual describes the APS (Assembly Programming System) language, 
which can be used within the following GE~100 Line Operating Systems: 
1) DOS Mise Operating System for GE-115's using DSS130 disc subsystems) 
2) TOS (Tape Operating System for GE-115) 


3) DOS II (Dise Operating System for GE-115's using DSS110 or DSS161 
disc subsystems) 


4) EDOS (Extended Dise Operating System for GE-120 and GE~130) 
5) ETOS (Extended Tape Operating System for GE-120 and GE-130) 


The APS language offers some differences, as described in this manual, 
depending on the Operating System in use. 
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This manual is divided into six parts, as follows: 


I. 


Iv. 


VI. 


GENERAL DESCRIPTION - a description of the APS language 
and its use. 


FORMAT AND DETAILED DESCRIPTION - a description of the 
characteristics of the APS, a detailed explanation of the 
symbolic recognized by the system, its instructions, and when 
and how it is used. 


INPUT/OUTPUT SYSTEMS - sets of subroutines controlling the 
input/output operations. 


EXAMPLE of APS usage. 


OPERATING PROCEDURES - a description of the general rules to 

be followed when translating the source program and executing the 

object program; the messages and error signals printed by the 
assembler during program translation, and a list of the HLT instructions 
that may occur during execution of the object program. 


APPENDIXES - include information not belonging to any of the Parts T 
through V, but is rather a useful reference material. 
Appendix A contains the Glossary. 


An index follows the appendixes. 


The first four parts are specifically addressed to programmers and applications 
specialists. Part V (Operating Procedures) is also provided for operators. 


For the best use of this manual, the reader should be familiar with the other 
software packages described in the publications listed in Appendix B. 
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I. GENERAL DESCRIPTION 


APS (Assembly Programming System) is a machine-oriented, one-to-one 
language which expresses in symbolic form all the primary instructions 
in the computer, thereby making full use of the machine's hardware. 


The use of APS rather than machine language facilitates program layout 


and reduces the possibility of error when writing instructions and fixing 
addresses. 


Organization 


The program written by the user in APS language is called the source 
program and consists of: 


- organization instructions 
- primary instructions 


- macro-instruetions, both APS (arithmetic and control) 
and input/output. 


The APS assembler is the program that translates the source program 
written by the user into the object program compiled in machine language. 
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The function of the APS assembler, therefore, is to generate an object 
program intelligible to the computer by reading the instructions that 
make up the source program and by reacting accordingly. 


Organization instructions are not translated into machine instructions 

but are used by the assembler to determine the organization of the object 
program. Primary instructions are translated directly into machine 
instructions by a one-to-one-form of translation. Some of the macro-instruc- 
tions are translated into a series of machine language instructions; some 
macro-instructions call subroutines that may or may not be part of the 
input/output systems and that will be assembled in the object program; 
others, concerning BIOS, are translated only into jump instructions to the 
BIOS routines (Basic Input/Output System) which are always present in 
store. 


In Figure 1, the translating functions of the APS assembler is described 

by means of a graph. The assembler, as organizer and transiator of 
instructions and as assembler of subroutines (level 2, Figure 1) reads the 
instructions of the source program in APS language (level 1, Figure 1) and 
generates an object program (level 4, Figure 1) by assembling in the main 
program the required BIOS input/output subroutines and any other subroutines 
either written by the user or relative to the control of peripherals not 
controlled by BIOS subroutines (level 3, Figure 1). 


After the translation, the object program is ready to be processed (level 5, 
Figure 1). During program execution, physical processing of the files is 
carried out by the BIOS routines. 
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Figure1. APS MAJOR BLOCK DIAGRAM 
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The APS assembly program is. written on the System Tape (under TOS or 
ETOS), on the System Disc (under DOS, DOS II or EDOS), and is called 

by the .APS order card. (More detailed information about program tapes, 
discs and order cards is given in the Operating System manuals listed in 

Appendix B. The .APS card layouts are given starting on page 288 of this 
manual) 


Segmentation 


Segmentation is a very important function of the APS program, but is not 
shown in figure 1 for reasons of clarity of the diagram. The program can 
consist of a single segment, in which case it always resides completely in 
store, or it can consist of several segments, in which case a single segment 
can be called individually and overlaid totally or partially on the area already 
occupied by other segments. 


When a required segment is to be inserted in store, it is called by means 
of the CALL macro-instruction which restarts the program from an address 
specified in the CALL by the user. 


This address can be that of an instruction belonging to the segment in store 
or to the same calling segment. 


A segment can call any other segment. The first segment is stored and then 
started either by the . PRL (under ETOS, TOS or DOS) and . LOAD (under 
EDOS or DOS 0) orders or by the Monitor of another program. 


Each program segment in its turn can be divided into sections. All sections 
of a segment are stored simultaneously and, therefore, cannot be overlaid. 
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When preparing a program to be divided into segments and 
sections, the following rules mist be adhered to: 


ae the program must begin with the STR? instruction 
and end with the END instruction. 


b. each segment, must begin with: 


- the STRT instruction, if it is the first in the 
program 


- any instruction, if it follows the first. 
each segment must end with: 


~ the END instruction, if it is the last in the 
program 


- the ESOM instruction, if it is not the lest in 
the program. 


Ca the section must begin with: 

- the STRT instruction, if it is the first in the 
program, that is, the. first section of the first 
segment 

- any instruction, if it follows the first section 
and also if it belongs to segments following the 
first segment. 

the section must end with: 

- the END instruction, if it is the last in the 
program, that is, the last section of the last 
segment 


- the ESGM instruction, if it is the last in a 
segment 


- the ESCT instruction, if it is within a segment. 
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Zt should be noted that even though a segment 

(except the first in’ the program) ean begin with 

any instruction, it must begin with the ORG 

instruction if it ia to overlay, either wholly or in 
. part, @ preceding segment, 3 


Figure 2 illustrates tie organization of a program consisting 

of two segnents, the first of which is divided into three 

sections and the second into two, The chart shows the, position 
occupied by each directive instruction, The CALL macro instruction 
required to load segnent two, is located in segment one, 


Segmentation offers particularly interesting possibilities 
for implementing certain acyclic program operations, euch as 
file open and close, and reel change. 


Since file open and olose operations, programmed with OPEN 
and CLOSE macro instructions, are normally carried ot only 
once at the beginning and at the end of e program, they can 
easily be programmed in two distinot segments, one segnent 
containing all the OPEN, the other all the CLOSE macro . 
inatructions, 


The operations that take place during normal program 
processing, such ap reel ehange, require particular procedures 
for segmentation, A part mst be found in the main 

program that is not subject to modification, euch as a 
fixededata table or a sequence of instruotiona not ta he 
compiled, This part of the program mist then be made inte an 
independent segment, The resulting format of the program ia 
ap follower: 


Begment A — sontaina the main part of the pragram 
segmnet B ~ contains the recoverable part 


gegment C ~ sontaine the acyclic operation; for example, 
peel change. 
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ORGANIZATION OF A SEGMENTED PROGRAM 
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The operations that take place during normal program processing, such as 
reel change, require particular procedures for segmentation. A part must 
be found in the main program that is not subject to modification, such as a 
fixed-data table or a sequence of instructions not to be compiled. This part 
of the program must then be made into an independent segment. The 
resulting format of the program is as follows: 


segment A - contains the main part of the program 
segment B - contains the recoverable part 


segment C ~ contains the acyclic operation; for example, 
reel change. 


When processing begins, segment A calls segment B, thus starting the 
normal processing cycle. When executing the acyclic function, it calls 
segment C, which overlays segment B, and starts it. Segment C, after 
being executed, calls segment B and restarts segment A. 

USE OF APS 

Hardware Configuration 


The minimum system configuration required by APS depends on the 
Operating System used and is therefore shown in the associated manuals, 
as listed in Appendix B of this manual. 

Software Environment 


The APS assembler can be used with DOS, TOS, DOS I, EDOS or ETOS. 
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I. FORMAT AND DETAILED DESCRIPTION 


INFORMATION ABOUT APS LANGUAGE 


Language Characteristics 


With the different language instructions, APS can express all the instructions 
recognized by the computer. The advantages are the following: 


- the indication of the operations to be carried out by means of 
mnemonic codes (MVC to indicate a transfer, AB e binary 
addition, ete.) 


- the writing of the constants and other parameters of the program 
in the required form (binary, alphanumeric, hexadecimal) 


- the using of symbolic names for the data fields and for the 
relationship between instructions without having to assign store 
positions. 


Furthermore, with specific macro-instructions, APS can generate entire 
sequences of instructions that give a rapid layout of the operations used 
most frequently, such as input and output or file opening and closing 
operations on disc, tape, card reader or printer ( the last two operations 
are only possible under EDOS or ETOS). 


APS language is used in two distinct phases: 


a. the layout in ordered sequence of the instructions that make up 2 
program. This is called the "source program". 


b. the transformation of the source program into machine language , 


that is, language intelligible to the computer. This is called the 
“object program", 
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The obvious advantages of the APS language are: 


-increased programming speed 

-reduced probability of error 

~greater facility on the correction of errors 
-ease in executing modifications. 


2, Instruction Types 


APS language instructions are divided into: 
a) organization instructions, which include: 


- directive instructions, which are required by the assembler 
to control and translate the source program 


- declarative instructions, which define the elements on which 
the program operates (data files, constants, store areas, etc). 


~ list control instructions, which determine the organization of the 
object program list 


b) primary instructions, which direct a genuine operation (transfer, 
jump, comparison, add, etc). and correspond to normal machine 
language instructions, 


c) APS macro-instructions, including: 
- control macro-instructions, which check the execution of a 
program (for example, execution of a subroutine or giving 


program control to the Operating System) by interrupting 
sequential execution. 
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- arithmetic macro-instructions, which direct the four algebraic 
operations with the possibility of specific options. 


d) input/output macro-instructions, consisting of: 
- BIOS macro~instructions, which execute physical input/output 
operations by using the BIOS routines 
- EIOS macro-instructions, which execute the physical and logical 


operations on the input/output files by using the EIOS routines, 


- input/output subroutine macro-instructions, which execute the 
physical and logical operations on the input/output files by 
using the subroutines not included in EIOS. 


Organization instructions 


Organization instructions are reserved exclusively for the assembly 
program. 


The directive and declarative instructions supply all the data and 
information required by the assembly program in order to obtain 
a correct program in machine language. 


These instructions are used to indicate: 


- the start of the source program (directive) 


- the length of the store areas occupied by the input/output data 
(declarative) 


- the value and the length of constants that are useful to the 
source program (declarative) 


— ete, 
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These instructions are not translated into corresponding instructions 
in machine language but simply impose a certain organization on the 
assembly program. For example; an instruction with the symbolic 
code DS (area definition) reserves a store area the instruction DC 
(constant definition) stores the constant expressed in the statement, etc. 


Primary instructions 


Each primary instruction is translated into the corresponding machine 
language instruction. 


Input/Output and APS macro-instructions 


The input/output and the APS macro-instructions can, with a single 
expression, program those operations not directly executed by the 
computer which would otherwise require the layout of a series of 
machine instructions. 


The APS macro-instructions are translated into a series of machine 
language instructions assembled in the main program or into a jump 
instructions to a subroutine inserted in the main program. The input/ 
output macro-instructions are translated into jump instructions to 
subroutines that may or may not to included in EIOS and that are 
inserted in the main program or into a jump instruction to one of the 
BIOS routines. 
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3. Symbols Recognized 


a. Characters of the graphic set 


The GE-100 Information Processing System recognizes the standard 
64-character graphic set, shown in Figure 3, Each number, letter, 
or symbol in this set hag a unique binary value represented internally 
by the eight binary digits of one octet. 

The internal representations of the pgraphic set are only a part of the 
256 possible binary configurattens of octets. 


The octets is the smallest addressable unit in the system and consists 
of eight bit positions representing the eight memory planes. 


The assembly program accepts symbolic characters, decimal figures, 

or hexadecimal values for defining data. Binary representations cannot 
be used. If it is necessary to work with binary figures, the correspording 
value must be expressed in the program by one of the authorized 
representations. 


The symbols and characters that are reserved for the assembler, 
together with their specific functions, are described below. 


b. Reserved symbols 
The symbols of the graphic set that are reserved for the assembler and 
that cannot be used for defining field and instruction names are as 


follows: 


Ps, (Cpt -* BS 
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Graphic Binary Graphic adecimal 
Conta. Character oe 


01000000 0 40 10100000 t AO 
0001 1 41 0001 J Al 
0010 2 42 0010 K A2 
0011 3 43 0011 L Ag’ 
0100 4 44 0100 M A4 
0101 5 45 0101 N AS 
0110 6 46 0110 [o} AG 
0111 7 aT 0111 P AT 
1000 8 48 1000 Q AB 
1001 9 49 1001 R Ag 
1010 [ 4A 1010 - AA 
1011 a 48 1011 $ AB 
1100 e 4c 1100 . AG 
1101 : 40° 1101 ) AD 
1110 > 4E 1110 i AE 
1414 ? aF nM * (pos AF 

trophe) 

01010000 (blank) 50 10110000 + BO 
0001 A 51 0001 , 81 
0010 B 52 0010 8 B2 
0011 c 53 0011 T 63. 
0100 D 54 o100 U B4 
0101 E 55 101 v BS 
0110 F 56 0110 WwW B6 
0111 a 8ST 0111 x B7 
1000 H 58 1000 v 68 
1001 1 59 1001 Zz BO 
1010 & 5A 1010 - BA 
1041 ‘. 5B 1011 + (comma) 6B 
1100 j sc 1100 % Bc 
1101 ( 5D 1101 = 6D 
1110 < 5E 1110 = BE 
cine) \ 1111 


Figure 3 - The GE 100 Series Graphic Character Set 
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- Aphostrophe ' 


Two apostrophes are used to delimit the data fields, one to the right 
and one to the left of the data being specified. To express the apostrophe 
in C-type constants, two consecutive apostrophes must be written. 
-Comma , 
The comma is used to separate operand specifications, when more 
than one operand is specified. 
- Parentheses ( ) 


Parentheses are used to contain length definition when this specification 
accompanies a field reference, They can also contain a reference 
address. 


- Arithmetic signs + - 


Arithmetic signs (+ or — ) are used to modify a symbolic operand 

specification, The sign is followed by a decimal increment or decrement. 
- Asterisk * 

The asterisk is used in two ways. 


. An asterisk used for operand specifications indicates that the address 
of the specified operand refers to the left octet address of the 
instruction in which the asterisk appears. 


. An asterisk used as an operation indicates that the operand specifications 
field contains a comment to be printed during assembly. 
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- Blank # 


The blank indicates the end of the fields that make up the APS 
instruction (name, operation cede, operands). 
One or more blanks can be written between the two apostrophes 
that delimit a C-type constant. . 

- Slant / 


(EDOS and ETOS only) 

The slant is used in operand specifications for relative addresses. 
It separates a relative address (on the left) from the number of an 
index register (on the right). 


Field delimiter 

Operand specification separator 
Length specification 

Increment specification 


Decrement specification 
As an operand specification: indicates store assignment 


As an operation: indicates a comment 


Indicates the end of the areas of an APS instruction 


Indicates address modification using index registers 
(in ETOS/EDOS only). 


Figure 4, Table of Reserved Symbols and their Uses. 
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Alphabetic Symbols 


In addition to the above symbols, the APS uses the following alphabetic 
symbols: 


ACXKLRESDY 


The programmer can use these letters in the names of fields, eonstants, 
etc, The letter Y, however, must not be used as the initial letter of a 
field name, constant, or instruction because the names of system 
subroutines always begin with ¥Y. Thus a new system subroutine could 
have the same name as that defined by the programmer in his program. 


-A 


The letter A is used in a constant definition instruction to indicate 
that the constant must be stored internally in the form of an address. 


-c 
The letter C in the operand specification field of an instruction 
indicates that the data item following C and contained between 
apostrophes is a character belonging to the graphic set (i. e. 
0-9, A-Z or a symbol). 
In an instruction defining a constant, C indicates that the symbols 
of the graphic set are being used to define constant data. 


-x 
The letter X appearing in the operand specification field of an 
instruction indicates that the two alphanumeric characters enclosed 
by apostrophes are the hexadecimal symbols that define the operand 
character, In a constant definition instruction, X indicates that one 
or more pairs of hexadecimal digits are being used to define constant 
data. 
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= 


The letter L precedes the length specification in instructions defining 
a field or a constant. 


-R 


An R in the operand specification field of an ORG instruction sets the 
value in the store assignment counter to the next higher multiple of 256. 
(No rounding off is done if the value is already a multiple of 256.) 

The store assignment counter is 2 part of the assembler and is used 
for assigning addresses to instructions and data. 


-spD 


The letters S$ and D are used in the Line Feed (LF) instruction as line 
spacers.. S requires a single skip. D requires a double skip. . 


-X¥ 


In the system software, the letter Y is used as the first letter of the 
subroutine names. 


Control characters 


There are three special purpose control characters used by the Edit 
(EDT) instruction. They are represented in hexadecimal form as 20, 
21, and 22. These three octets do not correspond to any of the 
characters in the graphic set and must be represented in assembly 
language instructions by pairs of hexadecimal digits. 
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B. HOW TO WRITE INSTRUCTIONS IN APS 


1. Use of the Programming Form 


Programs are written in symbolic language on the appropriate programming 
form (see Figure 5). 


Each line in the form corresponds to a language instruction and is divided 
into the following fields; 


- PAGE NUMBER 

~ PROGRAM IDENTIFICATION 

- LINE NUMBER 

- NAME 

— OPERATION CODE 

- OPERANDS 

- CONTINUATION 

- COMMENT 
Instructions are punched on cards. The instruction proper is punched 
from column 7 to column 72, The identification codes {page number, line 
number, ete.) are punched in the other columns. 
The end of each instruction is indicated by a blank. Character C in column 


72 indicates that the continuation of the instruction is punched on the 
following card, starting with column 25. 
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Figure 5 - APS Programming Form 
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Page number (columns 2-3) 
This indicates the progressive numbering of the pages in a program. 


The page number is written at the top of each program form and is 
punched on all the cards of the same page. 


Both page and line number (see description of line number, below) 
must be in ascending order since they are used to sort all the cards 
in a program. 


It is, therefore, useful though not obligatory to give the page number 
a numeric value. 


Program identification (columns 73-80) 


This is the code that identifies the program and is common to all the 
cards of a given program. It can be completely or partially alphabetic 
and appears in the heading of the programming form. This area 
however, is optional. 


Line number (columns 4-6) 
Line numbers are in ascending sequence within a page. 


Line numbers are printed on the programming forms and are multiples 
of 10. This permits the insertion of other instructions when necessary. 
For this purpose there are unnumbered lines at the bottom of the form. 
Between lines 040 and 050, for example, a maximum of nine lines can 
be inserted (041, 042, 043, etc.)., Also, lines between instructions can 
be left free. 


23 


APS REFERENCE MANUAL 


Name (columns 7-17) 
‘This is a group of alphabetic and numeric characters. 


One of the outstanding advantages of the APS language is the use of 
the name. When processing data and constants or when referring to 
instruction addresses, it is sufficient to express these data, contants 
or addresses with a name for the APS assembler to assign each a 
position in store as well as an address and a length. 


The name given to an instruction also serves to identify it within the 
program,: thus permitting any reference whatsoever. If no reference 
is required, this area can be left blank. 


The name cannot have more than six characters and must always begin 
in column 7 with any letter but Y; columns 8 to 12 may contain numbers 
and letters, but not special characters. Blank () characters are hot 
allowed in the middle of the name. 


‘The name must be defined only once in a section. Otherwise, an error 
signal is given. 


Columns 13-17 must always be left blank. 

Operation code (columns 18-23) 

This identifies the type of operation being carried out by the instruction. 
It is a mnemonic code that can represent either a function code, in the 
case of primary instructions, or a generic command for the assembly 
program, such as a request to reserve areas, definition of constants, etc. 
There is a fixed symbolic code, always starting in column 18, for each 


instruction. This code has a maximum length of five characters and 
must be quoted in each instruction, 
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Operands (columns 25-71) 


An operand is the iters of information processed (or operated upon) by 
an instruction. An instruction can specify different kinds of operands. 


Operands can be: 
- Data fields 


The data processed by an instruction can be located in a store 
area lying outside the positions occupied by the instruction or they 
can lie "within" the instruction. The latter type has been defined 
as "immediate" to distinguish it from data not contained in the 
instruction, 


- Instructions 


Instructions, or parts of them, can be the object of processing. 
In this case, their address or the address of one of their data 
items, appears in an instruction's operand area, For example, 
a program sequence can be interrupted by jumping to the address 
of an instruction. Also, an instruction can be either completely 
or partially substituted or modified. 


- Characteristic machine elements 


Names of peripheral units, status conditions of peripheral units, 
and UF/OF and ZE/NZ indicators can be specified as operands. 


~ Index registers (EDOS/ETOS only) 
Index registers can be specified as operands when they are used 
as data receiving fields, such as add fields in certain arithmetic 


operations, or as store areas for addresses that will be modified 
by. other instructions, 
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The operands must bé represented in the number and form 
appropriate to each instruction. 


The operands can vary in number according to the type of instruction. 
They are separated from each other by 2 comma. 


The operands area of all instructions, with the exception of DC and 
FILE instructions, must always be on a single card, that is, end 
with column 71. 


Continuation (column 72) 


When character C is punched in this area, it means that the instruction 
does not end on the card but is continued on the following card, beginning 
with column 25. 

Note that, when an *, I,S or T character is punched in col, 72, in DOS TI, 
EDOS or ETOS, this card is considered as a specific type of comment 
card, as described on page 112, 


Comment 


The comment is punched in the operands area and at Jeast one blank (i) 
character separates it from the information appropriate to this area. 


This area can be used to give each instruction information that will be 
useful in the program's debugging phase. The comment is considered 
only by the assembly program since after translation it is coupled with 
the corresponding machine language instructions in the printouts. 
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Operand Specifications 


APS instructions can specify one, two or no operands according to the 
type of operation to be executed. 


The methods of specifying operands vary according to the type of operand 


and the type of operation. Operand specification begins in column 25. 

Each operand specification is separated from another by a comma. There 
can be no blanks between column 25 and the last columa of the area 
containing the operand specification. If an instruction does not require an 
operand specification, leave the operand specification field of the instruction 
blank. 


Methods of specifying operands are described below. 
a. Field symbolic addresses 
The operand can be indicated by a name (symbolic address). In the 


course of the program, this name must appear in an instruction's 
name area, 


Example: 


ceweans  tcerne femincnan vecnmae Lad 


Ge ie) GES, PRORan Hane ‘PROGRAMMER | DATE 
APS PROGRAMMING FORM pr, LL 


ono 


nase oreeapon orenanos 


ofzto 


otto 


o:a'o) 


oso) 


The instruction on line 010 transfers the content of the BETA field to 
the ALPHA field. The names (symbolic addresses) of these field have 
been defined by declaration instructions. 


The instruction on line 040 is a jump instruction to the GAMMA field, 
which corresponds to the above MVC instruction: 
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This method of representing the operand is practical and offers 
considerable advantages. In fact, when changing the data, adding 

or cancelling instructions, the program works perfectly without direct 
intervention on the lengths and addresses. 


b. Absolute addresses 


Absolute addresses may be used to define operands in Core Store, 
but symbolic addresses should preferably be used, as they are eaiser 
to remember and reduce the possibilities or errors if programs 

have to be modified. 


When operating under EDOS in particular, the use of absolute addresses 
is normally allowed only in the STRT instruction and in the instructions 
referencing Core Store areas included in BIOS. If used outside these 
two cases, the instruction will be translated in the normal way, but 

an A symbol will be printed as well (see page 300) to notify the 
programmer. 


The Store absolute address must always be expressed by a decimal 
number with one to five digits. 


Note that an increment or decrement cannot be used to modify the 
absolute address, 


Example: The program initial address in a 16K system is 3800. 


centhar @ necrmie seomncanese [i] 
eA LOE MON et nr te oo 
aimee TREAT RE —- * 
APS PROGRAMMING FORM —* ROG c J 
thin, le e 
ee oregon crenawes 


TO ian H 
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Symbolic addresses with increments or decrements 


When an instruction refers to the name of a field, it means that it operates 
from the first position of the identified field, that is, the leftmost or the 
rightmost according to the type of instruction. 


It is, however, possible to modify the initial address of the operated 
field (right or left) by a certain number of positions preceding or 
following the field's start position. 


tf, that is, a programmer wishes to reference a position which has not 
been named, he can do so by using the name of a specified field.- Beside 
it he writes the number of positions between the octetto he processed 
and the first octet of the field considered, prefixing this number with 
a+ or - depending on whether the octet to be processed lies to the right 
(larger address) or to the leit (smaller address) of the start of the 
reference field. 


For example, if ALPHA is the name of a data field of five octets and 
the programmer wishes to reference the third octet of ALPHA to 
compare it, using a Compare Memory to Immediate (CMI) instruction, 
with the character $, he writes ALPHA + 2 in defining the operand. 


Similarly, if the programmer wishes to reference the octet to the left 
of ALPHA with the CMI instruction, he writes ALPHA - 1. 


}-————_—_———__— veto atena ————_——_—_——+ 


AtPHA~T ALPHA + 2 
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The instructions referring to these operations are: 


cenena. ceri ee verso LE] 


a ane FRGGRan Wane Ce a (oT) 
APS PROGRAMMING FORM erin, bh 


tal gr AL IPA iM 
ne HH 

The increment or decrement must be expressed by a number having 
from one to five figures. Avoid writing the non-significant zeroes. 
The symbols + and - are the only symbols accepted by the assembler 
to define the change. 


d. Relative addresses (EDOS/ETOS only) 


An instruction or a data field (which is not an immediate operand) can 
be specified realtive to the address contained in an index register 
modified by a specific quantity (relative address), 


The quantity modifying the content of the index register can have a 
value ranging from 0 to 4095. If its value is 0, the operand address 
corresponds exactly to the contents of the index register. 


EXAMPLE: 
If the character % is to be written in the first position of the ALPHA 
field, whose address has previously been loaded in index register 5, 


the proper coding, using a relative address-type operand, is as 
follows: 
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IDENTIFICATION 


PROGR Name 


PROCRET 


orasien 


Dare 


FROTRAM 0. 


= 


TT to aa 
WR EMAC) 
LTE OTT 


If the character is to be written in the tenth position of the ALPHA 
field, the instruction is: 


eNriFICArION 


vverneaes Ld 


preeriu o, [2 ee 
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APS PROGRAMING FOR 
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SE 


The modifying quantity in a relative address operand must always be 
expressed as a decimal number. 


Registers 6 and 7 are normally used by the system standard subroutines. 
e, The asterisk 

The asterisk symbol (+) can be used as an operand. It always represents 

the function code address of the instruction in which it appears as operand. 

Like field names, it can be followed by an increment or a decrement. 

The use of the * as an operand is not recommended. Meaningful names 


are always easier to understand and remember, and errors can be 
avoided if programs must be modified. 
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For example, if another instruction were to be inserted in the group of 
instructions following the LOOP instruction, the programmer would have 
to change the * -14 operand specification since the instruction named 
LOOP would no longer be 14 positions from the Jump Unconditional 

(JU) instruction. 


EXAMPLE; 
GENERAL GB etectnic IDENTIFICATION piaeeaees AR 
Fao TE FRR RE] 
xy pRocaan io. Le leo} 
l Lt 
iit 
i J 
The instruction on line 050 should be written: 
seven. @ accom rome rvecnwoe LL] 
‘Ge. 100 SEES PAGER NE 55 Sam RS 
Le Ee | .. LTT 
ry 

allege oregon orenanos F 
att ae, ea olde » cee 
fo 2fo t 
[39] H ia 
oslo H Hl] 
fo|sfol | TLE 
olelolF HR ul H ine | 
folate] i [i TT I 
olalo HA 
10} 910] Hi nl 
Too t | 
rit] H o COTO TCO L 
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Data fields and lengths 


An operation which acts on variable length fields always 
requires a definition of the length of the field. 


If the length involved in the operation is that of the 
data field named, the length 16 implicit in the operand 
and need not be specified, In all other cases where a 
variable length operation 1s to be performed, length 1s 
the number of octetes used in the operation. 


The length ia written ae a decimal number enclosed in 


’ parentheses immediately to the right of the data field 


epecification. Its value must fall within the permitted 
range of operand lengths (from ‘ to 5) for the particular 
operation the length of whose operands it defines: (It 

is not necessary to specify the non-significant zeroes), 


EXAMPLE: 


: [eet 2 3h ae, ae 
Sirois Som ae wie Mepees WUITTIES 


Multiply the content of the operand with length 7, 
located at the address of BETA~350, by-a 13-octet 
operand located at the address contained in register 
5 incremented by the quantaty 3023. 
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Immediate operands 


In a source program instruction, an operand oan be 
specified by an immediate character. The character is . 
inserted in the complementary code during trangletion of 
the instruction. 


There are three waya of specifying an immediate operand, 
Tt can be expressed as a graphic set character, a 
hexadecimal value, ov a decimal number. 


In the first method, the spesifiable characters are the 
64 of the graphic set, each one of which ogoupies a 
atore position. 


Ju symbolic representation, the operand must be preceded 
by the character C and placed between apostrophes. 


EXAMPLE: ° 


epnenac @ tuserao . . woemincaren ree AR 
art ne foal 


In the second method, the operand can be specified by 
one of the 256 possible configurations of the hexadecimal 
representation. In symbolic representation, the operand 
must be preceded by the character X:placed between 
apostrophes. 


vo 
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EXAMPLE: 
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ono 7 ctor 
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folato} | i 
forsiol | |i ESS i jet 
In the third method, the operand is represented by a numeric value 
between 0 and 255. Distinctive characters are not required in symbolic 
oO representation. 
EXAMPLE: 


cemenat GD euecrac ‘eomincaron 


GE 100 SERIES 


i H 
a iit 


Note that for all 64 characters of the "dense graphic set", any one 
of the three specification modes can be used to represent the required 
binary configuration on eight bits. 


'@} EXAMPLE: 
cre! alphanumeric form 
X46" hexadecimal form 
70 decimal form 
will in each case be translated as 0100, 0110. 


Where the alphanumeric form is not possible, the hexadecimal or 
decimal form must be used, 
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EXAMPLE: 


X'8F" hexadecimal form 
143 decimal form 


will be translated as 1000 1111. 


For these and other forms of representation, the restrictions on the 
number of usable characters, the store positions occupied, etc. depend 
on the type of instruction and the way in which the instructions are 
used. 


Indicator conditions 


In the conditional jump instructions, the first operand is a value 
(condition) which permits examination of the positioning of the UF/OF 
and ZE/NZ indicators. This test condition can be specified in two ways, 
as a hexadecimal or as a decimal number. The methods of coding are 
similar to those for defining an immediate operand (see paragraph g, 
page 34). 


The Table of Conditions Generated by Primary Instructions in Appendix D 
indicates the correspondence between the qualitative results of the 
various instructions (contained in the UF/OF and ZE/NZ indicators) 

and the value (condition) assigned to the first operand of the Jump 
instructions. 


EXAMPLE (applicable for EDOS and ETOS) 
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A jump to address SIGMA is ordered if the result of operation AP is 
greater than or equal to zero (ALPHA>0). 


Index register names (EDOS/ETOS only) 


The instructions operating on the eight index registers of the Central 
Processor (Type 4 primary instructions, page121)specify as first 
operand the name of an index register by means of a decimal figure 
ranging from 0 to 7. , 


EXAMPLE: the address of the data field named IOTA is loaded in index 
register 1. 


scone] |Z] 


operation 
‘obe 


I ; LT 
LO ea TT Abie i 


erat 


je 


Peripheral unit names 


Instruction PER (Type 7 primary instructions, page 126)specifies as 
first operand the name of a peripheral unit. The value of this operand 
must be expressed in decimal or hexadecimal form. The methods of 
coding are similar to those for defining an immediate operand (page 34). 


In Appendix D, the names that can be specified for peripheral units are 
given in the Table of Possible Configurations of Peripheral Unit Names. 
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EXAMPLE: 


cenenas Qeuerae ecpcins rcrnoae Le] 
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orcobe 


if 
lela, 1p, 
Execute.the peripheral operation specified by the DELTA field on the 
peripheral unit named CO. (in this case, it is a printer with integrated 
controller linked to connector 1.) 


C. DESCRIPTION OF THE INSTRUCTIONS 


1, Organization Instructions 


Organization instructions are only used by the assembly program to organize 
the translation of the object program. 


a. Directive instructions 
Directive instructions are not translated into instructions for the computer 
but contain some of the information required by the APS assembler for 
generating the object program, 
They are used, for example, to fix the program's initial address and start 


address, to indicate the end of a section, segment, or program or to 
fix the initial address of store areas or instructions. 
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The following directive instructions are described on pages 40 to 50. 


STRI 
ESCT 
ESGM 
END 
ENTRY 


ORG 
RORG 


Program Start 

End of Section 

End of Segment 

End of Program 

Declare Names Common to Several Sections and 
Segments. 

Assign Origin Address 

Restart Origin Address 
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STRT 
Program Start 


DESCRIPTION: this instruction, always placed at the start of each program, 
supplies the APS assembler with the initial address of the 
program and the store size. 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: STRT 


OPERANDS: OP. 1 Core Store address (in decimal) where the object 
program is loaded (initial address). 
The following table shows the permissible values of 
OP.1, depending on the system configuration, whether 
the programs to be executed on a system reading 
Hollerith (H) or Bull (B) cards, and whether the program 
calls for a file table. 


Tapes only Tape/dise If program. 
Discs only configuration uses file table 


Hl =] H B 
DOS 


21600 |21800 {22100 |e 2300 | < 4000 


TOS 

DOs 1 2 2500 22700 |23100 {23300 < 4300 
EDOS 2 3800 24000 124800 [25000 = 
q) 

ETOS 2 2400 2 2600 - - 3 3496 
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NOTE 1: 7268» OP.15 9540, if BIOS includes tape routines, or if 
Bull card reader is connected. 


NOTE 2: Should the initial address be> 3496, OP.1 must be > 12, 288, 
if core capacity permits. 


OP.1 must be zero if the STRT is used at the beginning of 
a subroutine. 


OP.2 Size of Core Store where program is to be executed. 
May be expressed by one of the following values,2, 
3,4,6 or 8(each representing a multiple of 4096 octets) 
Le. 


2= 8,192 octet Core Store 
3 = 12, 288 octet Core Store 
4= 16,384 octet Core Store 
6 = 24,576 octet Core Store 
8 = 32,768 octet Core Store 


If the value specified is not one of those shown, it is 
considered as being equal to 4 (in EDOS or ETOS) equal 
to 2 (in DOS, TOS or DOS I). 


EXAMPLE: Specify a program initial address of 3800, ina 24,576 
octet Core Store. 


cenenas @eterne womnesnan rvcenoaes i] 
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ESCT 


End of Section 


DESCRIPTION: this instruction signals the end of a section. 
INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: ESCT 


OPERANDS: Optional comment (£30 characters, in DOS, TOS or DOS I) 
to appear in the printout after translation, as heading of 
the subsequent section. 


GENERAL @D etectatc ‘oewriicerion pace mauaen Lela 
a oaks PROGRAn NRE rn a dd 
APS PHocRAMING FORM eS ee rsa. bt [J 


OPERATION PeRAn 
une | wane nar OPERANDS 


[Scant 


0} 1/0] y 

jo] zj0 
ogo 
ong 
10 5/0) 
era 
[pire i 
oreo] it i 
foi siol 7 f 
DOC Naan Ee 


nn 


COMMENT: each section must end with the ESCT instruction except for the 
last section of a segment, which ends with the ESGM instruction; 
and the last section of the program, which ends with the END 
instruction. This instruction may not be used within a subroutine. 
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ESGM 


End of Segment 


DESCRIPTION: this instruction signals the end of segment. 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: ESGM 


OPERANDS: Optional comment {#30 characters, in DOS, TOS or DOS 11) 
to appear in the printout after translation, as heading of the 
subsequent segment. 


GENERAL @ tuecraie \eomincsrion 
GE - 100 SERIES PROGRAM NAME PROGRAMMER mee 
APs PROGRAMMING. FORA [acca 
oregazeon orenanos 
ISEM, 


foretol hy : at 


COMMENT: cach segment must end with the ESGM instruction, except for 
the last segment of the program, which ends with the END instruction. 
This instruction may not be used within a subroutine, 
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END 


End of Program 


DESCRIPTION: this instruction signals the end of the source program to 
the APS assembler and also gives the indication of the 
start address of the translated program, 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: END 
OPERANDS: the instruction consists of a single operand that indicates 
the start address of the object program. The address can 
be indicated with: 
-a symbolic name, with adjustment if required 
- a decimal value (for ETOS only). 


cenena @ cutcraie 
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{OENTIFICATION 


COMMENT: the start address must be the address of a primary instruction 
belonging to the first-segment of the program. 
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ENTRY 


Declare Names Common to Several Sections and Segments 


DESCRIPTION: in a program written in APS 130, the same names can be 
used in different. segments and sections and have different 
meanings. For example, in the first section the name ALPEA 
can be used to define a constant while in a subsequent 
section it can be used as the name of an instruction. 


It might be useful to use the name ALPHA in the second 
section with the same meaning it had in the first section. 


In this case, the name ALPHA must be indicated to the 
assembler by the ENTRY instruction. 


The entry instruction, therefore, is used to signal all 


names used with the same meaning in several sections of 
one segment or in several segments. 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: ENTRY 
OPELANDS: OP.1, OPs2, ccccnsencccceecvencosccsaccscrerconssOPall 


The operands must be names with no adjustment. 


EXAMPLE: after having defined the constants ALPHA and BETA, it indicates 
that they are also used in other sections of ‘the program. 
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NOTE: 


in an ENTRY instruction, as wany names can be indicated 
successively until colusm 71 is filled. They cannot be continued 
on the following card, 


With 2° 16K store, as many EVIRY inetructione can be used until 
750 namea are declared, The maxinum number of names that can be 
used in a seotion, including those declared in the ENTRY 
inestractions, is 1100, 


In the ENTRY instructions, names of subroutines and names that 


appear in the FILE and OR@ instructions are not declared because 
thay are defined by the assembler. 
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Assign Origin Address 


DESCRIPTION: 


this instruction modifies the value of the Store Assignment 
Counter. The assignment counter is controlled by the APS 
assembler which, starting from the address indicated in the 
STRT instruction, assigns an address to the various areas, 
constants, and instructions, by updating the counter itself. 


INSTRUCTION FORMAT: 


“NAME: not used 
OPERATION CODE: ORG 


OPERANDS: 


the instruction consists of a single operand that indicates 

the value to be substituted for the one contained in the address 
counter. 

When this operand has a value less than the minimum allowed 
by the Operating System, it prints the signal M (see page 301). 
It can be represented by: 


- a symbolic name, with or without adjustment (may not 
be the name of a subroutine). In this case, the 
assignment counter contains the address corresponding 
to the name plus or minus any adjustment. 


The symbolic name is inserted by the APS assembler 

in the Entry Table. It must have been previously defined 
as an instruction name, constant name or storage area 
name. 


- a decimal value (for ETOS only). In this case, the 
assignment counter contains the value indicated. 


47 


APS REFERENCE MANUAL 


— the character * followed by an adjustment. 


The character * represents the current value of the 
counter. In this way, the counter can be adjusted backwards 
or forwards. 


- the character R. In this case, the current value of the 
assignment counter is rounded to the nearest multiple of 
256. If the assignment counter's value is already a multiple 
of 256, the instruction has no effect. 


- the character R with an adjustment. In this case, the 256 
multiple address less than or equal to the current address 
of the assignment counter is considered and the adjustment 
is made. 


The address thus obtained is taken as the new origin if it is 
greater than or equal to the current address; if not, the 
256 multiple address greater than the current address is 
considered and adjustment is made. 


In a Subroutine, only operand R (without adjustment)is allowed. 


EXAMPLE: 

bua convenes rane 

ces a a 

fe aie ren LTT 
OPERATION A 


im 
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The first ORG instruction orders the increment of the assignment 
counter by 50 positions, thus leaving a free area. The second ORG 
instruction sets the counter back by 80 positions, that is, to the 
ALPHA instruction ; the DS following defines an area with length 10 
and with the same initial address as the ALPHA instruction. 
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Assuming that the assignment counter has a decimal value of 2560 
before the ORG instruction, after the ORG instruction it will have a 
decimal value of 2624. 


Assuming, however, that the assignment counter has a decimal value 
of 2630 before the ORG instruction, after the ORG instruction it will 
bave a decimal value of 2880. 
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RORG 

Restart Origin Address 

DESCRIPTION: this instruction interrupts the coneecutive assignment of 
addresses. It substitutes the current value of the address 
counter with the value it had before the execution of the 
last ORG instruction encountered in the course of the 
program. 

INSTRUCTION FORMAT: 

NAME: not used 


OPERATION CODE: RORG 


OPERANDS: none 


EXAMPLE: 

cenennt @ aac ween vue mone La] 
Ge. wosencs oom Fae | FE | 

oi retin a ane Ld 


ena oreRanos 


Ce 


i TMA 
oso] i | 
esol a Sonnet Ld. .. T 
While the ORG instruction sets the counter back by 6 positions for the 
definition of a BETA field, the subsequent RORG instruction repositions the 
counter to the maximum value it has reached previously, that is, before 
examining the ORG instruction. 


NOTE: This instruction may not be used within a subroutine. 
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Declarative instructions 


Declarative instructions are used by the programmer to define the 
elements on which the program operates. They define the format 
and type of file processing (on cards, printer, tape or disc), the 
store areas, the constants that are operated during processing, and 
the specifications of the Input/Output operations. 


Declarative instructions are not, therefore translated into machine 
instructions. When these instructions are encountered, the APS 
assembler stores parameters or constant data or simply reserves 
areas for programmer's use. 


The declarative instructions are as follows: 


DS: Define Store 
DC Define Constant 
DP Define Peripheral 


FILE Define File: defines a card or print file (in EDOS/ETOS 
only), a magnetic tape or disc file. 


Programming Note: In DOS, TOS or DOS U, up to ten FILE instructions 
mmay be written in a program. In EDOS or ETOS, up to 22 FILE instructions 
may be written in a program:up to 20 concerning tape and/or disc files, 
only one card file and one print file. 
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oO 


Furthermore the FILE instructions must immediately follow the STRT 
instruction but list control instructions may be inserted in between and 
also intermixed with the FILE instructions. 


The FILE instructions are used by the Assembly program to generate 

the file table. This contains all the information required by EIOS for 

processing the files, and is assembled ahead of the first segment of 

the user program; The file table consists of as many records as there 

are files and may not be more than 2016 octets in length, in EDOS or 

ETOS, or more than 1152 octets in DOS,TOS or DOS II (the format of 

the file table is described in the Appendixed of the Operating System Oo 
Manuals). 


The programmer should take care, in using the ORG instruction, that 
the file table be not overlaid hy the following segments, as it must 
remain unaltered in Core Store. 


For the organization of disc, tape, card and print files, see Data 
Files Organization manual. *) 


The discussion of the FILE instructions is subdivided in two parts, 
for ETOS/DOS/TOS and EDOS/DOS Ii respectively, as their formats 
may be different in the two cases. 


- In ETOS/DOS/TOS, the description of each FILE instruction contains 
the specific information required for its use (see pages 66 to 87). Oo 
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- In EDOS/DOS II some general rules can be set out regarding the use 
of the FILE instructions (pages 75 to 109): Each FILE may be written 
on one or more lines of the programming sheet, as required by the 
number of operands. 


If the operands specification field cannot contain all the parameters 
required, the instruction must be continued on the operands 
specification field of the next line, starting from column 25. 


The "FILE" operation code must be specified on the first line only, 
and the character "C" must be indicated in col. 72 of each line, 
except for the last one. Column 71 must always be left blank, the 
character "comma" must not be the last in the operands field and the 
specification of each operand must begin and terminate on the same 
line. 


The operands can be specified in any order except that the first 
operand is always the file symbolic name. 


All symbolic names appearing as operands in the FILE instructions, 
are inserted by the APS Assembly program in the Entry Table. 


NOTE: The instruction FILE may not be used within a subroutine. 
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DS 


Define Store 


DESCRIPTION: reserves one or more store areas and assigns a symbolic 
name to the first one, 


INSTRUCTION FORMAT: 


NAME: any name that has as its value the area address and as its length 
the length of the first area. 


OPERATION CODE: DS 


OPERANDS: the instruction consists of a single operand with the following 
structure: 


dLn 


where: 


-d is the duplication factor indicating how many times 
the store area is to be repeated. If the duplication 
factor is 


1 it can be omitted 
0 an address is given to the name of the 
area without actually reserving it 


The maximum value for the duptication factor 
is 256. 


-L _is a separator 
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-n is the actual length in characters of the defined 
area. The length must always be present and must 
have a value ranging from 1 to 256. 


COMMENT: if the duplication factor is set equal to zero, the length and 
address are given to the name appearing in the name field. The 
assignment counter, however, is not advanced. In this way 
sub-areas can he defined within an area, 


cenenn @ aeerme romnctron ree woae LL 
ae FSR aaa oar 
APS PROGRAMMING FORM TRE IO. ise) 
oregon orenanos A 
lod { 


: 
HHH in 


The area named CARD will be defined three times by reserving 
45 %3 positions, The value given to the name CARD is the 
address of the first reserved area and the length is 45. The area 
named READ, however, consists of 200 characters. 
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EXAMPLE: 


@ soem race noes LL} 
Ge. ww sens cor RE —— 
pg beeen ee 


ortearon 
bg 


Progwia io. Leh 


Only the DATE and VALUE areas are reserved in store and are, 
in effect, sub-areas of CARD. The advantage is that when the 
two areas are called simultaneously, it is necessary to refer 
only to the name CARD. In fact, even though the area is not 
reserved in store, the name is given a length and an address. 


The addresses of the DATE and VALUE areas are not relative to 
the initial address of CARD but are the actual addresses. 
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DC 


Define Constant 


DESCRIPTION: stores any kind of constant. 


INSTRUCTION FORMAT: 


NAME: any name that has as its value the address of the area that 
contains the constant and as its length the length of the constant. 


OPERATION CODE: DC 


OPERANDS: the instruction consists of a single operand corresponding 
to the constant that is to be defined. The operand is made 
up of four elements with no blanks between them. These 
are; 


- Duplication factor: it establishes how many times the 
constant specified in the operand is to be generated. 
It must be a decimal number ranging from 1 to 256. When 
it equals one it can be omitted. 


-Type of constant: by means of an alphabetic character 
it indicates the form in which the constant is to be stored 
and considered. 


Possible types of constants are: 


- C alphanumeric form (one store position for each 
character expressed) 


- X hexadecimal form (one store position for two 
characters expressed) 
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-A binary form (from 1 to 4 octets for each constant) 
under DOS H, EDOS or ETOS; from 1 to 3 octets, 
under DOS or TOS8). 


- Length of constant: it is expressed by a decimal number, 
preceded by the letter L. Maximum length depends on the 
type of constant. 


- Constant: it must be placed between apostrophes for types 
C and X and in parentheses for type A. 
The length of the assigned store area for each constant is 
given by: 
q.L 


where:. 


-d_ is the duplication factor 
-L is the length of constant, 


EXAMPLE: >: 

cenenar @ ceccrate : sine sdeueeolels 

me FRE Teo — 

APE PROGRAMMING FORM rasa, be a 
| 

tage oneaow orenanos B 
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COMMENT: if the constant expressed as operand has a length that cannot be 
contained on a card, it can be continued on several lines of the 
form, each line ending with an apostrophe (in any column) and with 
character C in column 72 (except the last line). The subsequent 
lines start with an apostrophe in column 25. 


The symbolic code DC must be indicated only on the first line. 


Note that the length of the constant, as assigned by the Assembler 
in the Name Table (see page 288) is that specified after the 
character "L" in the DC instruction, thus ignoring the duplica- 
tion factor. For example the constant 5CLI1'0’ occupies five store 
positions, while the length recorded in the Name Table is one. 


Types of constants 
-Type C constant: alphanumeric form 


Use: With the type C constant all the characters belonging to the 
graphic set can be expressed and then stored in memory. 
Each occupies a store position. 


If the constant contains an apostrophe, this must be 
written twice. 


Length: the length must never exceed 256 characters. There is 
an error signal if it does or when the number of characters 
between apostrophes is greater than the declared length. 


If, on the other hand, the length is greater than the number of 
characters actually appearing in the constant, enough 

blanks (4) are placed in store, to the right of the constant, 
until the specified length is reached. 
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EXAMPLE: 

rete @ axe cermerme rae 
ps onan: Fo pai aeeet a rin, LOO) 
an i +f 
BB of | ne i CL| ee f Li 
alias dual imslattnatia H 


constant CST 1 is stored in the memory 

ROMEKROMEKS 
constant CST 2, however, signals error I (operand incorrect). 
- Type X constant: hexadecimal form 


Use: each character specified in the constant is written in a quartet 
in core store. 


All 256 configurations of the GE-100 internal code can be written 
in hexadecimal form (See page 16), 


Length: indicates the number of positions occupied by the constant 
{one position for every two characters expressed) and must 
never exceed 256. If it does, an error signal (I) is given. The 
same type of error occurs when the number of characters 
expressed in the constant is odd or more than twice the length 
indicated. If the number of characters expressed in the constant 
is less than twice the indicated length, the constant in store is 
lined up to the right (right justified) and the area to its left is 
completed with binary zeroes, 
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EXAMPLE: soewrrearon iiviten Ua) 
“we cei nace heal 
Se Ree orensrow orenanos : 
OOo ae : 

ata t 

fofalo} ; H [ Crh 

BOOL Ya ec rere Co Cocco 
BRCPe eee ee i HH 

aseeRE 


: HH a f ia LL HHH mal 


the instruction RED is translated: 


0000 0000 01271 1100 1000 1010 


0 0 t Cc 8 A 
en) LE Sey — 
pos. n pos. nt] pos. n+2 


the instruction BLACK is translated: 


0000 0000 0001 1011 


0 0. 1 B 
a YH—~ 
pos. n pos. ntl 


the instruction GREEN, on the other hand, gives the error signal I 
(operand incorrect). 


Type A constant: address form 


Use: an address is stored in binary by means of a decimal number 
or a symbolic name. 
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Length: the length expressed may not exceed 4, in DOS I, EDOS or 
ETOS: may not exceed 3, in DOS or TOS. 


If the length indicated is 4, the resulting constant contains the 
length (minus 1) expressed in two octets as well as the address. 
This type of instruction can be used only if the operand is expressed 
by a symbolic name, 


If the length indicated is 3, the resulting constant contains the 
length (minus 1) as well as the address. This type of instruction 
can be used only if the operand is expressed by a symbolic name. 


if the length expressed is 1 or 2, the operand is always translated 
in binary on two octets. In store, however, if the length is 1, only 
the least significant octet is written, 


EXAMPLE: 

OEMENaL @ eucerate semeTinicariet Pacemueen fH] 

Seas i ie a 9G CHUN 
: 

SOOT Ha 

aE Pr epeaceest CT + 

eps Maer HEE 

ooo i t 

ofziol tL CCRC 
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~ the constant HOUSE has a value 1; in binary, 257 occupies 9 bits, 
that is: 


100000001 


Since the length indicated is 1, corresponding to 8 bits, the leftmost 
binary position is lost and the constant is written in store as: 


09000001 
~ the constant ROAD is translated on three octets, the first of which 
contains the length while the other two contain, in binary, the left 
address of area SK 
~ the constant CST1, is translated on two octets as the address of SK + 5 
- the constant CST2, however, signals error I (operand incorrect) 
since it is not possible to indicate the address with the symbol * 
for this type of constant. 


NOTE: Ina subroutine it is not allowed to use DC's with character C in 
col, 72, and DC's of AL1 type using symbolic names as addresses. 
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DP 


Define Peripheral Operation 


DESCRIPTION: this instruction is used to generate in store an external command 
with a length of 2 or 6 octets. It is not normally used by the 
programmer but by the input/output subroutines supplied by the 
software. 

INSTRUCTION FORMAT: 


NAME: any name that has the address of the constant as its value 
and the length of the constant as its length. 
OPERATION CODE: DP 


OPERANDS: two or three that have one of the following configurations: 


where: 


-ZandX are the parameters defining the external 
command, Each can be expressed in hexadecimal 
or decimal form, as follows: 


hexadecimal (e.g., X'80") 
decimal (e.g., 128) 
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-I indicates the address of the first store position involved 
in the transfer. It can be expressed with: 


-a symbolic name, possibly followed by an adjustment. 
In this case, the name is given a value equal to the left 
address of the instruction with which the name is 
associated. 


-a decimal value 


- the character * followed by an adjustment. 
-n indicates the transfer length. 


If the address is expressed with a symbolic name, the 
length can be omitted, in which case it is made to equal 
the length of the memory area with which the symbolic 
name is associated. 


EXAMPLE: 
ceaenat ernie soon vue moor LL] 
(f- wosmnes sracnaa nae oe] ea Tel 
APS PROGRAMMING FORM ee a ea TT 

z 
ae cae ogo orenanps ° H 
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FILE DEFINITION IN ETOS/DOS/TOS 


FILE 
Define Card File 


DESCRIPTION: this instruction (not applicable for DOS/TOS)specifies all the 
information required for processing a card file. This information 
is needed by the assembly program to set up the file table. 


FILE occupies two cards. Character C must be punched in 
column 72 of the first card to indicate that the instruction 
continues on the next card. 


INSTRUCTION FORMAT: 
FIRST CARD 


NAME: not used 
OPERATION CODE: FILE 
OPERANDS: - OP,1 


Symbolic name used by program to reference the 
file. 


-OP.2DV=CR 


This operand indicates that the peripheral unit used 
by the file is the card reader. 


- OP.3 EV = (address) 


This parameter represents the address, expressed 
with a decimal value or 2 symbolic name, of the 
‘program sequence (prepared by the user) to be 
executed at end-of-file (a card is read with KEND 

in the first four columns, or hopper empty with EOF 
switch on). 
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SECOND CARD 


NAME: not used 
OPERATION CODE: not used 
OPERANDS: - OP.1i BA = (address) 


This parameter represents the store area address 

for the card read. It can be specified by a symbolic 
name, a decimal address, or the name of an index 

register. 

(Note: registers 6 and 7 cannot be used.) 


- OP. 2 BK = (length) 


It represents the length of the previous area expressed. 
by a decimal number with a value not greater than 80. 


EXAMPLE: 

sac er Fol TT 
fs aces Fe eres Kl 
‘Sue. mine ormaron OPERANDS H 


dat i 
a mm Hf 


The instruction defines a card file called ENTER. FIFL is the instruction that 
starts the processing sequence for end-of-file. CARD is the symbolic name with 
which the address of the card read area is associated. The area length is 80 


positions. 
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this instruction (not applicable for DOS/TOS) specifies all the 
information needed for processing a print file. This information 
is needed by the assembler to set up the file table, 


FILE consists of two cards, Character C must be punched in 
column 72 of the first card to indicate that the instruction 
continues on the subsequent one. 


INSTRUCTION FORMAT: 


FIRST CARD 


NAME: not used 


OPERATION CODE: FILE 


OPERANDS: - OP.1 


Symbolic name by which reference is made within the 
program to the file being processed. 


~OP.2 DV = PR 


This operand indicates that the peripheral unit used by 
the file is the printer. 


- OP.3 FL or VL 


This operand indicates that the output records are of 
fixed or variable length (FL or VL ). 
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PILE 


Define Tape File 


DESCRIPTION: this instruction contains the parameters relative to all 
the tape files, both input and output. These parameters are 
needed by the assembler to set up the files table. Hach 
instruction consists of three cards. 


. INSTRUCTION FORMAT: 
FIRST CARD 


NAME: not used 
OPERATION CODE: FILE 
OPERANDS: — OP, 1 


Symbolic name for reference within the program to 
the file being processed. 


- OP, 2MT=N 


The parameter N is a decimal number ranging from 1 
to 8, It indicates the select number of the unit 
used, 


~ OP, 3AT=N 


The parameter N is expressed like operand 2, It 
indicates the tape unit to be used, as an 
alternative to the previous one, for a file on 
several reels. 


This operand is not used if the file is on a single 
reel or if it does not have to be alternated with 
another unit. 
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- OP, 4 


This parameter indicates the structure of the 
records in the file. It can have one of the follow— 
ing values: 


FL the file is made up of fixed-length 
records - 


Vii the file is made up of variable~length 
records 


UN the filo is made up of Pecord-blocks, 
ives, each dlock ‘consists:'of a retord. 


- oP. 5 WE 


Key word indicating that the blocks are not 
numbered. The file maintains the standard 
organization. 


- OP. 6 WS = (address) 


This operand indicates that the file is organized 
in nos-standard mode. File opening and closing are 
executed by the program sequence whose address 

is specified in this operand. The address can be 
expressed in decimal form or with a symbolic 

name. The program sequence mat be prepared by the 
user. 


- oP. 7 W-=eP 


This operand indicates the type of controller for 
the tape units used 


MI. for standard controller. 


Ta 
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FILE 

Define Tape File 

DESCRIPTION: this instruction contains the parameters relative to all the 
tape files, both input and output. ‘These parameters are needed 
by the assembler to set up the file table. This instruction 
consists of three cards. In column 72 of the first two cards, 


the character C is punched to indicate that the instruction is 
contained on the card following. 


INSTRUCTION FORMAT: 
FIRST CARD 


NAME: not used 
OPERATION CODE: FILE 
OPERANDS: -OP.1 


Symbolic name for reference within the program to 
the file being processed. 


-OP,2 MT=N 
The parameter N is a decimal number ranging from 1 
to 8. It indicates the select number of the unit used. 
-OP,.3 AT =N 


The parameter N is expressed like operand 2. It 
indicates the tape unit to be used, as an alternative 
to the previous one, for a file on several reels. 


This operand is not used if the file is on a single 
reel or if it does not have to be alternated with 
another unit. 
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- OP.4 


This parameter indicates the format of the records 
in the file. It can have one of the following values: 


FL the file is made up of fixed-length records 
VL the file is made up of variable-length records 
UN the file is made up of single-record blocks, 
i.e., each block consists of one record. 
~ OP.5 NI 
Indicates that the blocks are un-numbered, but the 
file is standard. 
- OP. 6 NS = (address) 


This operand indicates that the file is organized in 
non-standard mode. File opening and closing are 
executed by the program sequence whose address is 
specified in this operand. The address can be 
expressed in decimal form or with a symbolic name. 
The program sequence must be prepared by the user, 


- OP. 7DV=MT 
Indicates that the file is on magnetic tape. 
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- OP. 8 EP or OP 


Indicates that the check of each file character must 
be executed with 


- even parity if EP 

~ odd parity if OP 
An odd parity check is assumed if this operand is 
not used, 


SECOND CARD 


NAME: not used 
OPERATION CODE: not used 
OPERANDS: - OP.1 BA = (address) 


Represents the store area (Block Area) reserved for 
the physical element (block), The address can be 
expressed by a symbolic name or a decimal! value. 


- OP. 2 BK = (length) 


Represents the length of the previous area (BA). 
This length is expressed by a decimal number not 
less than 80 and not greater than 27, 000 (in ETOS), 
not greater than 4096 (in DOS/TOS). 


- OP. 3 WA = (address) 


Represents the area (Work Area) reserved for the 
logical element (record). The address is expressed 
by a symbolic name, a decimal value or the name 
of an index register (in ETOS only), (Note: registers 
6 and 7 cannot be used). 


For input files and sequential processing, the name 
or address associated with the WA may coincide with 
that associated with the BA. 

This operand is not used for UN files, 


cc) 


THIRD CARD 
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- OP.4 RC = (length) 


Represents the length, expressed by a decimal 
number, of the previous area (WA). 


For files with numbered blocks, the value of the 
operand RC must be greater than or equal to 15. 


For files with un-numbered blocks, the length must 
be greater than or equalto 20. 


For variable-length records; the maximum length is 
1,028 characters. 


For files with fixed-length records (FL type), the 
parameter RC must be a submultiple of the parameter 
BK, for un-numbered blocks, or a submultiple of 
(BK-5) for numbered blocks. This operand and the 
preceding one are not used in the case of a file 
consisting of single-record blocks (UN file). 


NAME; not used 
OPERATION CODE: not used 
OPERANDS: - OP.1 EV = (address) 


Represents the address, expressed by a decimal 
value or a symbolic name, of the program sequence 
{prepared by the user) to be executed in the event 

of end-of-file, end-of-volume, or end-of-tape. 

This routine must only execute the specific functions 
of the program but not the general closing operations 
which are carried out by the CLOSE instruction. 


Re-entry to the main program depends on the routine 
itself? This operand is mandatory. 
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- OP. 2 OF = (address) 


Represents the address, expressed by a decimal 
number or a symbolic name, of the program 
sequence (prepared by the user) to be executed in 
the event of persistent error in file processing. 
This operand is optional. If it is not used the’ 
persistent error causes the program to halt on one 
of the tape~error standard HLT's. 


- OP.3 RM =6 or 8 


This operand indicates the type of magnetic tape 
used: 6 for 7 (6+1)-track tapes and 8 for 9 (8+1)- 
track tapes. If this operand is not used, it is 
assumed that the tape has 7 tracks. 


~- OP, 4 PK = 2,5,8 or P 


This operand indicates the recording density, as 
follows: 


2 = 200 bits per inch (bpi) 


5=556 " 7 Tt " 
g8=300 " 1 tt w 
Pe1g600 " moo 


This operand is optional. If it is not used it is 
assumed that 7-track tapes have a density of 556 bpi 
and that 9-track tapes have a density of 800 bpi. 
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-OP.5 RP = (nnn) 


mnn indicates the file's retention period, in number 
of days ranging from 0 to 999. This operand is 
optional; if it is not present it is considered as 0. 


EXAMPLE: 
cenennc@ nueeraie pees 
re STE FGF 
pierre 
tice | sae onegapon 
on TO 
ate Gi E 
ayo 5 
late 
else CTL 
belo CCU 


The instruction defines a file, ENTER, mounted on unit 2. 

The file is on a single reel and consists of fixed-length records. The 
controller is standard and an even parity check is requested. The blocks 
consist of 505 characters divided into five records each 100 characters 

in length. FIFL starts the end-of-file or end~of-volume processing sequence. 
There ig no routine for error checking. The tape used is 7-track with a 
recording density of 556 bpi. File retention is not requested. 
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FILE 
Define Dise File 


DESCRIPTION: (not applicable for ETOS) 
This instruction contains the parameters relative to all 
disc files both in input and in output. These parameters are 
required for the Assembler to prepare the File Table. 


This instruction is on five cards. In column 72 of the first 
four cards, character C must be punched, to indicate that 
the instruction continues on the following card. 


INSTRUCTION FORMAT: 


FIRST CARD 
NAME: Not used 
OPERATION CODE: FILE 
OPERANDS: -OP.1 


Symbolic name, used by the program to reference 
the file. 


- OP.2MT=N 


Where N is the logic number (from 0 to 9) of the 
disc unit containing the volume where the file is 
written or its first volume, if the file is multi- 
volume, In the case of random access to a multi- 
volume file, this operand specifies the logic number 
of the unit that contains the first volume. The units 
containing the other volumes of the file shall have 
logic numbers in consecutive ascending sequence. 


cal 
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- OP.3 AT=N 


Where N is the logic number, expressed as operand 2 of 
the alternate disc unit, if a multi-volume file is to be 
processed sequentially. This operand is not specified if 
operating in random mode, if file is single-volume, or 
if a multi-volume file is to be processed sequentially 
from a single disc unit. 


- OP.4 FL, VL or UN 


Specifies format of records in file, as follows: 


FL= Fixed-Length records 
VL =Variable-Length recora not allowed in random files 
UN= Unblocked records (single-record pages). 


- OP.S5 DV=DS 


This operand is always present. It indicates that the 
dise subsystem is DSS130. 
- OP.6FE=N 


Where N is the quantity (from 1 to 9) of the additional 
volumes in a multi-volume file. Significant only when 
operating in random or random-sequential mode. All the 
file volumes must be mounted, by consecutive ascending 
sequence numbers (chrts 28-31 of HDR1 label) on dise 
units with consecutive ascending numbers. For example, 
if the volume 0002 is mounted on unit 4 the volume 

0008 must be mounted on unit 5, and so forth. 


SECOND CARD 
NAME: not used 
OPERATION CODE: not used 
OPERANDS-OP. 1 BA = (address) 


Symbolic name or decimal address of the Block Area in 
Core Store, reserved for page processing. 
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~ OP.2 BK = (length) 


Decimal length of the BA field: between 80 and 4096 if 
file is processed sequentially; no more than 20 sectors; 
if file is processed in random or random-sequential 
mode. 

If recording mode is 8-bit, the Assembler also accepts 
parameter BK=75, and causes the signal 04 (see page 320) 
to be printed, which however does not affect normal 
processing. 

Regardless of the value of BK, note that if the file uses 
and Index, the Core Store area which is to receive the 
Block Area and is defined by a DS instruction, must 

be at least two sectors in length, namely: 


200 octets, if 6-bit recording mode 
150 octets, if 8-bit recording mode 


In fact, Index cylinder pages will be read into this 
Store area. 


- OP, 3 WA = (address) 


Work Area is Core Store, reserved for record processing. 
It may be specified by a symbolic name or a decimal 
address. 

Tn an input file is to be processed sequentially, the WA 
name or address may coincide with BA name or address. 
This operand is not specified for UN files. 


~ OP.4 RC = (length) 


Decimal length of WA field, subject to the following 
limitations: 


In VL files, up to 1028 octets 
in FL files, length must be a submultiple of BK, but not 
greater than 4096, 
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NAME: not used 
OPERATION CODE: not used 


OPERANDS - 


OP.1 FO=SorR 


Specifies the File Organization, as follows: 
§ = sequential file 
R = random file 


, This operand is optional. If absent, file is assumed to 


be of sequential type. 
OP,2 EV = (address) 


Symbolic name of a user-developed routine to be called 
by the program when an end-of-volume or end-of-file 
condition occurs. - 


Always required if operating in sequential or random- 
sequential mode. Not used in random processing. 

In the random-sequential mode this operand is significant 
only for end-of-file because the end-of-voiume condition 
is handled by EIOS. 


OP.3 OE = (address) 


Symbolic name of user-developed routine, if any, to be 
ealled by the program in the event of read, write, 
positioning or verify, persistent errors. 


When this operand is not specified, a halt occurs to 
notify the error condition. 


OP.4 RM=6or8 


Specifies the data Recording Mode, as follows: 


6 = 6-bit mode 
8 = 8-bit mode 


This operand is optional. If absent, a 6-bit mode is 
implied. 
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- OP.5 PK =SorF 


Parameter specifying the track format in the file. It 
may have either of the following values: 


S= File is recorded in "sector mode" 
F = File is recorded in "fulltrack mode". 


This operand is optional. If absent, track format is 
assumed to be in sector mode, 


- OP. 6 RP= NNN 


NNN is the file Retention Period, i.e, the number of 
days, from zero to 999, to be added to the file creation 
date inthe HDR1 label, to obtain the new purge date. 


According to the type of file, the purge date is computed 
and recorded in the HDR1 label at the following times: 


when "opening" a sequential file, 
when generating the HDR1 label of a random file. 


This operand is only used, if required, when recording 
a file, but must not be used for file updating (see fifth 
card OP.2 page y5 ). absent, the file purge date is 
not changed. 


NAME: not used 


OPERATION CODE: not used 


OPERANDS:- OP.1 DA = (address) 


Symbolic name of an eight-octet field which is to receive 
the Disc Address of a record, a page ora track This 
field is used by the programmer (either directly or 
indirectly through an algorithm) to address a record in 
random mode, or by the I/O macro-instructions to 
communicate to the programmer the dise address of the 
record being processed. This parameter must be indicated 
if the operand AM was set = M or R. 
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The DA field is formatted as follows from left to right: 


« If the record address is supplieds. by the 
programmer or an I/O macro-~instruction (GET 
or PUT): 


One octet indicates the sequence number, from 0 
to 9, of the volume in the file. 


Five octets indicate the page address. 


Two octets indicate the record sequence number in 
the page (first record is 00). 


This addressing method allows random access to 
records in both random and sequential files. The DA 
operand may also be used in sequential processing, 
when the dise addresses of the records being processed 
are required. 


e If page or track address is supplied by the programmer: 


One octet indicates the sequence number, from 0 to 
9, of the volume in the file. 


Five octets indicate the address of a page or of a 
track. 


Two octets are set to decimal zero. 


This addressing method (by page or track) can only 
pe used for random processing of random files. 


DA may be defined = 0 only in sequential processing 
when the address of the records being read or written 
are not required. 


Note that subroutine instructions handling the DA field 
operate on right quartets only. Therefore the user 
must provide correct left quartet configurations, if the 
field is to be printed or recorded. 
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- OP.2 FA = (address) 


Symbolic name or decimal address of the Core Store 
area which is to receive the file Index. This area 

may not be between addresses 5376 and 6276, this 
interval being used by the subroutine called by the 
OPEN macro-instruction. 

To be specified only for sequential files using an Index 
also when multivolume. The length (LA) of the FA area 
can be obtained by the following formula: 


Lea = (i, +6)n 


where Le = length of the record key: 


1 to 20 for 6-bit recording mode 
i to 15 for 8-bit recording mode, 


n= number of volumes in the file. 


When the FA operand is used, the Block Area must be 
at least 200 characters (two sectors) long, because 
this is the length of each page in the Index (See Op. 2 
in the Second card) 


- OP.3 KA = (address) 


Key Address: Symbolic name or decimal address of 
the Core Store field which is to receive the record 
key. Record keys must always be supplied by the 
programmers, when intending to access record in 
random mode. This operand is not used in sequential 
processing and is optional in random processing using 
record addregses. 
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- OP.4 KS = (length) 


Key Size: Decimal number indicating the length of the 
KA field. Maximum values for files using Index: 


15 octets, if 8-bit recording mode 
20 octets, if 6-bit recording mode 


If file has no Index, the KA field may be up to 255 
octets in length. If a sequential file with overflow 
area is processed in random mode; this limit is 
reduced to 249 octets if records are VL to 251 
octets if records are FL. 


This operand must always be specified (KS = 0) when 
the chaining field is used, whether or not KA is 
defined. 


- OP. 5 RA = (address) 


Record Address: Symbolic name or decimal address 
of the Core Store field which is to receive a new 
record for file updating. These records are supplied 
by the programmer. ‘The length of this field is set 
by the APS Assembler, as follows: 


equal to Work Area, if FL or VL file 
equal to Block Area, if UN file 


Tn random processing, this field may coincide with the 
Work Area or the Block Area, provided the record 
previously read into WA or BA is not significant when 
a new record is to be prepared in the RA field by the 
programmer, 
FIFTH CARD 
NAME: not used 


OPERATION CODE: not used 
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OPERANDS: - OP.1 AM=S, RorM 
Access Mode: Specifies the access mode, namely: 


§ = sequential access (processing) 
R= random access (processing) 
M= random ~sequential access (processing), 


This operand is optional. If absent, sequential 
processing is implied. 


- OP. 2 UP 


Specifies that the file is to be updated. Absent if 
reading or recording a file. UP and RP (see third 
card, OP. 6) must not be specified in the same FILE 
instruction. 


- OP, 3 RI=CH, PG, SS or MS 
Record Insert 


» For a file to be updated, specifies the method for 
inserting records in the file, as follows: 


CH = (only for sequential files using overflow area) 
Insert records in the overflow area, using 
chaining method. 


PG = (for random files only) 
Insert record in the first area available in the 
page whose address is specified in the DA field, 
If search fails in that page, the record is 
rejected, 


8S = (for random files only) 
Insert record in the first area available in the 
track whose address is specified in the DA field. 
If search fails in that track, the record is 
rejected. 


MS= (for random files only) 
Same as SS; but if search fails in that track, it 
continues in the adjacent tracks of the same 
cylinder 
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« For a file opened in input, this operand signifies 
the following types of access: 


PG = Search page whose address is in the DA field 
(page addressing). 


SS = Search track whose address is in the DA field 
(track addressing), 


MS = Same as SS, but the search continues in the 
subsequent tracks of the same cylinders (track 
and cylinder addressing). J 


- OP. 4 NV 


No Verify: Optional operand indicating that no check is 
to be performed on a page after recording. Not allowed 
when updating a file. 


- OP. 5 BF 


Optional operand indicating that the file is recorded in 
two areas not adjacent in the same volume (Broken File). 


EXAMPLE: 


SEWERAL GD evecrnte. 


wpeerincariee 


SIs[s[=]= [= 131 
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Define the file EXIT, for updating in random mode, 
as follows: 


File contained in two dise packs (volumes), which are 
mounted on units 2 and 3. 

Sequential file with fixed-length records. 

Six-bit and sector mode recording; 


Field PAG, 400 octets long, to receive page in Core 
Store. 


Field ZSET, 200 octets long, to receive record in Core 
Store. 


Routine ERRO developed by user to handie persistent 
error conditions. 


Field REC, to receive the address of a record on disc. 
Field IND, to receive the file Index. 


Field KEY, 10 octets long, to receive the record Key. 


Updated record to be inserted in file, is prepared in 
field RECOR. 
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FILE DEFINITION IN EDOS/DOs II 
FILE 
Define Card File 


DESCRIPTION: this instruction (not applicable for DOS'II) specifies all the 
information required by EDOS for processing a card file. 
This information is needed by the assembly program to set 
up the file table. 


The general rules to be followed in writing this instruction are 
indicated in page 53. 


INSTRUCTION FORMAT: 
NAME: not used 


OPERATION CODE: FILE to be specified on first line only if the 
instruction consists of two or more lines. 


OPERANDS: - OP,1 

Symbolic name used by the program to reference the file. 

-OP.2DV=CR 
This operand indicates that the peripheral unit used by 
the file is the ecard reader. 

- OP, 3 EV = (address) 
This parameter represents the address, expressed with 
a decimal value or a symbolic name, of the program 
sequence (prepared by the user) to be executed at 


end-of-file (a card is read with BEND in the first four 
columns or hopper empty with EOF switch on), 


88 


APS REFERENCE MANUAL 


- OP.4 BA = (address) 


Specifies the address of the Block Area by means of a 
symbolic name, or the name of an index register. 
(Note: registers 6 and 7 cannot be used. ) 


- OP.5 BK = (length) 


Specifies the length of the Block Area by means of a 
decimal number (not greater than 80) 


EXAMPLE: 
cenenns @ cserme convent seenseee La 
ies rears on ene a eeres les : ELIT 
ran Eo « 
lala ENTER DVIECA) EVEIENIFLD IRA=cAlRO) BAKES [| 
agg t 
O60 H r i 
ello H I 

q H 
ele tort in a ina 


The instruction defines a card file called ENTER. FIFL is the instruction 
that starts the processing sequence for end-of-file. CARD is the symbolic 
name representing the address of the Block Area. The length of the Block 
‘Area is 80. 
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FILE 


Define Print File 


DESCRIPTION: this instruction {not applicable for DOS Il) specifies all the 
information needed by EDOS for processing a print file. 
This information is used by the assembler to set up the 
file table. 


The general rules to be followed in writing this instruction 
are indicated in page 53. 
INSTRUCTION FORMAT: 
NAME: not used 


OPERATION CODE: FILE (to be specified on first line only is the 
instruction consists of two or more lines). 


OPERANDS: - OP. 1 


Symbolic used by the program to reference the file. 


- OP, 2 DV=PR 


This operand indicates that the peripheral unit used 
by the file is the printer. 


- OP, 3 FLor VL 


This operand indicates that the output records are 
of fixed or variable length (FL or VL). 
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- OP, 4 EV = (address) 


Symbolic name specifying the address of the program 
sequence (prepared by the user) to be executed at end-of- 
form. 


- OP. 5 OE = (address) 


Symbolic name specifying the address of the program 
sequence (prepared by the user) to be executed in case 
of print error or out~of-service. 


This operand is optional. 
- OP. 6 BA = (address) ~ 


Specifies the address of the Block Area by means of a 
symbolic name or the name of an index register. (Note: 
registers 6 and 7 cannot be used). 


- OP. 7 BK = (length) 


Specifies the length of the Block Area by means of a 
decimal number (not greater than 162, if FL file, not 
greater than 163, if VL file). 


EXAMPLE: 


cevennt cere ees vaemoe La] 


oe eee rent Sie 
eee a ee 


eobe" 


8 
[Scourin 


i 
oo 

ol 

fx 
fe 
St 
ics 
=) 
i= 

i 

well 

ig 

{5 
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The instruction defines a print file called EXIT consisting of records 
of variable length. At end-of-form, the program sequence with name 
FIMO must be executed. No routine is provided in the event of a print 
error or an out-of-service condition. The address of the record to be 
printed is contained in register 3. The maximum length of the record 
is 136 positions. The parameter BK must have the value of 139; i.e. 
the length of the BA area, which includes three service characters 
plus the 136 characters to be printed. (See "Print Files" in "Data 
File Organization Manual). 
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FILE 
Define Tape File 


DESCRIPTION: this instruction specifies all the information required for 
processing a file both in input and output. This information 
is used by the assembler to set up the file table. 

The general rules to be followed in writing this instruction 
are indicated in page 53. 


INSTRUCTION FORMAT: 
NAME: not used 


OPERATION CODE: FILE (to be specified on first line only if the 
instruction consists of two or more lines). 


OPERANDS: - OP.1 


Symbolic name used by the program to reference the 
file. 


-OP.2 MT=N. 


The parameter N is a decimal number ranging from 1 
to 8. It indicates the select number of the unit used. 


- OP, 3AT=N 


The parameter N is expressed like operand 2, It 
indicates the tape unit to be used, as an alternative to 
the previous one, for a multi-volume file (alternative 


unit). 


This operand is not used if the file is single-volume 
or if it does not have to be alternated with another unit. 
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~ OP.4 
This parameter specifies the format of the records in the 


file. It can have one of the following values: 


FL the file is made up of fixed-length records 
VL the file is made up of variable-length records- 
UN the file is made up of single-record blocks 
i.e., each block consists of one record. 
- OP.5 =NI 


Indicates that the blocks are un-numbered, but the file 
is standard, 


- OP, 6 NS = (address) 


This operand indicates that the file is organized in non- 
standard mode. File opening and closing are executed by 
a user-supplied sequence whose address is specified in 
this operand by means of a symbolic name. 

-OP.7 DV =MT 


Indicates that the file is on magnetic tape. 
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- OP, 8 EP or OP 
This operand indicates that the check of each character 
in the file must he of either of the following types: 


~ even parity if EP 
- odd parity if OP. 


This operand is optional; if absent an odd parity check is 
assumed. 


- OP. 8 BA = (address) 


Represents the store area (Block Area) reserved for the 
physical element (block). The address must be expressed 
by a symbolic name, 


- OP. 10 BK = (length) 


Represents the length of the previous area (BA). This 
length is expressed by a decimal number not less than 80, 
not greater than 27,000 (in EDOS) or 4096 (in DOS II). 


- OP. 11 WA = (address) 
Represents the area (Work Area) reserved for the logical 
element (record). The address must be expressed by a 


symbolic name, or (in EDOS only) by the name or an 
index register, (Note: registers 6 and 7 cannot be used), 
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~ OP, 12 RC = (length) 


Represents the length, expressed by a decimal number, 
of the previous area (WA). 


For files with numbered blocks, this value must be 
greater than or equal to 15, 


For files with un-numbered blocks the length must be 
greater than or equal to 20. 


For variable-length records the maximum length is 
1,023 characters, 


For files organized with fixed-length records (FL type), 
the parameter RC must be a submultiple of the parameter 
BK, for un-numbered blocks, or a submultiple of (BK-5) 
for numbered blocks. 


This operand and the preceding one are not used in the case 
of a file consisting of single-record block (UN file). 


- OP. 13 EV = (address) 


Represents the address, expressed by a symbolic name, 
of the program sequence (prepared by the user) to be 
executed in the event of end-of-volume, or end-of-~file. 
This routine must execute only the specific functions of 
the program and not the general closing operations carried 
out by the CLOSE macro-instruction. 


Re-entry to the main program depends on the routine 
itself. This operand is mandatory. 
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~ OP. 14 OF = (address) 


Represents the address, expressed by a symbolic name, 
of the program sequence (prepared by the user) to be 
executed if there is persistent error in file processing. 
This operand is optional. If it is not used the persistent 
error causes the program to halt on one of the tape- 
error standard HLT's. 


- OP, 15 RM=6 or 8 


This operand indicates the type of magnetic tape used: 
6 for 7 (6+1)-track tapes and 8 for 9 (8+1)-track tapes. 
If this operand is not used, it is assumed that the tape 
has 7 tracks. 


- OP. 16PK=2,5, 8orP 


This operand indicates the recording density, that is; 


2 = 200 bits per inch (bpi) 
5=556 7 ™ ow ot 
8=800 " " on on 
P+1ig00 " " oo 


This operand is optional. If it is not used it is assumed 
that 7-track tapes have a density of 556 bits per inch and 
that 9-track tapes have a density of 800 bits per inch. 


OP, 17 RP = (onn) 
nnn indicates the file's retention period, in number of 


days ranging from 0 to 999. This operand is optional; if 
it is not present it is considered as 0. 
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EXAMPLE: 


cenenn @ cxecraic 
ees eae sa ea 


APS PROGRAMMING FORK 


ume | nase ovenagon 


OPERANDS ~ 


ind 
atm 
oct 
ri 
fab) 
iS 
Sit 
i 
1 
aa 
tela 
Sa 
SF 
1a 
rs 


The instruction defines a file, ENTER, mounted on unit 2. 
The file is on a single reel and consists of fixed-length records. The 
controller is standard and the even parity check is required. 


The blocks consist of 505 characters divided into five records, each 
100 characters in length. FIFL starts the end-of-file or end-of-volume 
processing sequence. There is no routine for error checking. The tape 
used is 7-track with a recording density of 556 bits per inch. 

File retention is not required. 
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FILE 


Define Dise File 


DESCRIPTION: this instruction specifies all the information required for 
processing a disc file. 


The general rules to be followed in writing this instruction 
are indicated in page53. 


INSTRUCTION FORMAT: 
NAME: not used 


OPERATION CODE: FILE (to be specified on first line only, if the 
instruction consists of two or more lines). 


OPERANDS: - OP. 1 


Symbolic names of file, used by the program to reference 
the file. 


~OP.2MT=N 


Where N is the logical number of the disc unit containing 
the entire file or its first volume (value from 0 to 9, 
Ato F, in EDOS; from 0 to 7, in DOS 1). 


-OP, 3AT=N 


Where N is the logical number of the alternate dise unit, 
if a multi-volume file is to be processed sequentially 
from both main (see OP. 2) and alternate disc units. 
Expressed the same as OP. 2. 
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This operand is not specified if operating in random or 
random -sequential mode, if file is single-volume, or if 
a multi-volume file is to be processed sequentially from 
a single dise unit. 


OP, 4 FL, VL or UN 


Specifies format of records in file, as follows: 


FL = Fixed~-length records 
VL = Variable-Length records (not allowed in random files) 
UN = Unblocked records (single-record pages) 


OP. 5 DV =DS 


This operand is mandatory, indicating the disc subsystem 
being used: DSS161 or DSS110. 


OP. 6 FE=N 


Where N is the quantity (from 1 to 9 in EDOS, from 

1 to 7 in DOS IJ) of the additional volumes in a multi- 
volume file. Significant only when operating in random 
or random-sequential mode. The first (see OP. 2) and 
the additional volumes must be mounted by consecutive 
ascending sequence numbers (chris 28- 31 of HDR1 label) 
on disc units with consecutive ascending numbers. For 
example, if the volume 0002 is mounted on unit 4, the 
volume 0003 must be mounted on unit 5, and so forth. 


OP. 7 BA = (address) 


Represents the store area (Block Area) reserved for the 
physical element (page). The address must be expressed 
by a symbolic name. 
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- OP, 8 BK = (length) 
Decimal length in octets of Block Area 


. h EDOS, 75 =BK =27,000 in sequential processing, 
BK = 20 sectors in random or random-sequential 
processing. 


- mn DOS I, % =BK&4, 096 in sequential processing, 
BK10 sectors in random or random-sequential 
processing. 


Regardless of the value of BK, note that, if file has 
an Index the Core Store area which is to receive the 
Block Area and is defined by a DS instruction, must 
be at least one sector in length, namely: 


384 octets, if 6-bit recording mode (EDOS only) 
288 octets, if 8-bit recording mode 


In fact, Index cylinder pages will be read into this 
Store area. 


- OP. 9 WA = (address) 


Symbolic name of the Work Area in Core Store, 
reserved for record processing. In ETOS a register 
name (other than 6 or 7) may be specified for sequential 
files used in sequential mode. In sequential processing 
of an input file, WA symbolic name may coincide with 
BA symbolic name. This operand is not specified for 
UN files. 
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- OP, 10 RC = (length) 


Decimal length of WA field, subject to the following 
limitations: 


In VL files, up to 1023. 

In FL files, length must be a sub-multiple of 
BK, but not greater than 4096. 

In UN files, this operand is not specified. 


-OP. 11 FO=SorRk 
Specifies the File Organization, as follows: 


S = sequential file 
R = random file 


This operand is optional. if absent, file is assumed to 
be of sequential type. 


- OP, 12 EV = (address) 


Symbolic name of a user-developed routine to be called 
by the program when an end-of-volume or end-of-file 
condition occurs. 


Always required if operating in sequential or random- 
sequential mode. Not used in random processing. In the 
random-sequential mode this operand is significant only 
for end-of-file because the end-of-volume condition is 
handled by EIOS. 
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- OP. 13 OE = (address) 


Symbolic name of a user-developed routine, if any, 
to be called by the program in the event of read, write, 
positioning or verify, persistent errors. 


When this operand is not specified, a halt occurs to 
notify the error condition. 


- OP. 14RM=6 or8 
Specifies the data Recording Mode, as follows: 


6 = 6-bit mode (in EDOS only) 
8 = 8-bit mode. 


« MN EDOS, this operand is optional; if absent, a 6-bit 
mode is implied. 


» DOS Z, this operand is mandatory. 
- OP. 15 RP = NNN 


NNN is the file Retention Period, i.e, the number of 
days, from zero to 999, to be added to the file creation 
date in the HDR1 label, to obtain the new purge date. 


According to the type of file, the purge date is computed 
and recorded in the HDR1 label at the following times: 
when "opening" a sequential file, 


when generating the HDR1 label of a random file. 


This operand is only used, if required, when recording 
a file, but must not be used for file updating (see OP. 22). 
If absent, the file purge date is not changed. 
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- OP. 16 DA = (address) 


Symbolic name of an eight-octet field which is to receive 
the Disc Address of a record, a page or a track, This 
field is used by the programmer (either directly or in- 
directly through an algorithm) to address a record in 
random mode, or by the I/O macro-instructions to 
communicate to the programmer the disc address of the 
record being processed. 


This parameter is mandatory in the following cases: 


when AM =M, AM=R 


The DA field is formatted as follows from leit to right: 


« If the record address is supplied, by the programmer 
or an J/O macro-instruction (GET or PUT): 


One octet indicates the sequence number (from 0 to 
9 in EDOS, or from 0 te 7 in DOS Il), of the volume 
in the file. 


Five octets indicate the page address, 


Two octets indicate the record sequence number in 
the page. 


This addressing method allows random access to 
records in both random and sequential files, The 
DA operand may also be used in sequential process- 
ing, when the disc addresses of the records being 
processed are required, 
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» If page or track address is supplied by the program: 


One octet indicates the sequence number (from 0 
to § in EDOS, or from 0 to 7 in DOS I) of the 
volume in the file. 


Five octets indicate the address of a page or of a 
pair of tracks, 
The two rightmost octets are set to decimal zero. 
This addressing method can only be used for random 
processing of random files. 

- OP, 17 FA = (address) 


Symbolic name of the Core Store area which is to receive 
the file Index. To be specified only for sequential files 
using an Index. The length (Lp,) of the FA area can be 
obtained by the following formula: 


a + 
Loa (ly 6) n 


where Ly = length of the record key: 


1 to 38 for 6-bit recording mode 
1 to 28 for 8-bit recording mode. 


n = number of volumes in the file. 


When the FA operand is used, the Block Area must 
be at least one sector long, because this is the length 
of each page in the Index (see OP. 8) 
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-OP, 18 KA = (address) 


Key Address: Symbolic name of the Core Store field 
which is to receive the record key; this must always 
be supplied by the programmer, when he intends to 
access a record in a random mode. This operand 
must not be used in sequential processing and is 
optional in random processing using record addresses. 


~ OP. 19 KS = (length) 


Key Size: Decimal number indicating the length of the 
KA field. Maximum values for files using Index: 


38 octets, if 6-bit recording mode (in EDOS 
only). 
28 octets, if 8-bit recording mode 


If the file has no Index, the KA field may be up to 
255 octets in length except in the case of sequential 
files with overflow area and of random processing, 
where this limitation is reduced to 249 octets for 
VL files, and to 251 octets for FL files. 


This operand must always be specified (KS= 0) when 
the chaining field is used, whether or not KA is 
defined. 


- OP. 20 RA = (address) 


Record Address: Symbolic name of the Core Store 
field which is to receive a new record for file updating. 
These records are supplied by the programmer. The 
length of this field is set by the APS Assembler, as 
follows: 

equal to Work Area, if FL or VL file 

equal to Block Area, if UN file. 


In random processing, this field may coincide with the 
Work Area or the Block Area, provided the record 
previously read into WA or BA is not significant when 
a new record is to be prepared in the RA field by the 
programmer. 
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- OP. 21 AM=5,R or M 
Access Mode: Specifies the access mode, namely: 


8 = sequential access (processing) 
R = random access (processing) 
M = random -sequential access (processing) 


This operand is optional. If absent, sequential 
processing is implied. 


-OP, 22 UP 


Specifies that the file is to be updated. Absent if 
reading or recording a file. UP and RP (see OP. 15) 
must not both be specified in the same FILE 
instruction, 


- OP. 23 RI=CH, PG, SS or MS 


« Files opened for updating: 
Specifies the method for inserting records in 
the file, as follows: 


CH = (only for sequential files using overflow 
area). Insert records in the overflow area, 
using chaining method. 


PG = (for random files only) 
Insert record in the first area available in 
the page whose address is specified in the 
DA field. If search fails in that page, the 
record is rejected. 


SS= (for random files only) 
Insert record in the first area available in 
the pair of tracks whose address is specified 
in the DA field. If search fails in that page, 
the record is rejected, 


MS = (for random files only) 
Same as SS; but if search fails in that pair of 
tracks, it continues in the adjacent tracks and 
cylinders. 
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« Files opened in input; 
Specifies the type of access to a record in 
the file, as follows: 


PG = Search page whose address is in the 
DA field. 


SS = Search pair of tracks whose address is in 
the DA field. 


MS= Same as SS, but the search continues in 
the adjacent tracks and cylinders. 


-OP, 24 NV 


No Verify: Optional operand indicating that no 
check is to be performed on a page after recording. 
Not allowed when updating a file. 
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The principal subroutines are: 


- YYSDS 
~ YYADS 
— YYMULS 
~ YYDIVS 


Input/Output Macro Instructions 


See paragraph 2.c, page 14, for a general description of, these 
macro instructions, their use, and their translation. 3 


Input/output macro instructions use subroutines and routines 
that contro] input/output files. These subroutines and routines 
make up the Input/Output Systems described in detail in part III. 


These macro instructions are: 
- BIOS macro instructions 


READ Read a Card 

VOR Validate Card, Reading 

PRINT Print a Line and/or Advance Paper on Printer 
‘Validate Printout 

LBSS Read Cards and Print 

MTAPE Operate Magnetic Tape Unit 

VMT Validate Tape Operation 

TAPE Operate and Validate Magnetic Tape Unit 


AK RR KOK KK 
5 


~ BIOS macro’ instructions 


+ card files 


OPEN Open File 
GET Read Card 
RLS ‘Close Operation on Card Reader 
CLOSE ‘Close File 
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- print files 


OPEN Open Pile 

PUT Print Record 

RLS Close Operation on Printer 
SKIP Paper Skip 


CLOSE Close File 


. tape files 


OPEN Open File 

cET Read Record 

PUT Write Record 
NEXT Change Volume 
CHKP Store Checkpoint 
RLS Pase to New Block 


CLOSE Close Volume or File 
- input/output subroutine macro instructions: 
SUB Call Subroutines 


*H. ON Commané Peripheral Operation 
NN Validate Peripheral Operation. 
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* 
Comment 


DESCRIPTION: this instruction has no effect during program translation but 
simply determines, during the list phase of the translated 
program, the printing of the characters written in the operand 
area, 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: * 


OPERANDS: the instruction consists of a single operand made up of 
a series of characters that can be used as a comment or 
as a heading for a given part of the program. 


EXAMPLE: 
ceneaa. @ tureraie semmcir iter al 
GE - 100 SERIES 7] 


APS PROGRAMING FORM 
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During object program listing, a special card (comment) can be used 
(in DOS I, EDOS and ETOS), in addition to the instruction * (comment). 
It is formatted as follows: 


cols. 1 - 6 Same as cols. 1 - 6 of APS programming form. 
cols, 7 -71 Comment to be printed. 
col, 72 Comment code. May be any one of the following values: 


* Comment to be printed immediately and in the centre 
of the form. 


I Comment to be printed after skip to top of page and 
double spacing. 

T Comment to be printed after double spacing, 

Comment continuation, after a comment card with I 
or T incol. 72. 


cols. 73 - 80 Same as cols. 73-80 of APS programming form. 


EXAMPLE: Print comment, more than 65 columns in length, on new 
page. 


GEMERAL @® ELecTRIC IDENTIFCATION PAGE MUDER AE 


GE~ 100 senies PROGR A NaE PROGRGGER | DATE 
APS PROGRAMING FORK oa. et 


vee 


AANA reRa ‘ck Nppolo) FEES! gel 
is M Bg 


q 
fo 
Q 
Q 
Q 
o 
q 

id 
q 
ol 


is 
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EJEC 


Jump to Next Page 


DESCRIPTION: the instruction hag no effect during program translation, During 
the list phase of the translated program it causes a skip to a 
new sheet before the next instruction is printed. This instruction 
can be used to demonstrate a given part of the cbject program. 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: EJEC 
OPERANDS: none 


EXAMPLE: 
== 

GENERAL QD eLectaic WWENTIFICATION pace wumper L112 
(GE 400 Semis 
APS PROGRAMING FORM ——rrstsinw. be a 

> ane oteation ae F 
ume | ror enanos 
P iT 
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LF 


Line Feed 


DESCRIPTION: this instruction has no effect during program translation. 
During the list phase of the translated program it executes 
one or two line feeds or a paper skip before the next 
instruction. 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: LF 


OPERANDS: the instruction consists of a single operand that can have 
the following values: 


8 single line feed 
D_ double line feed 
1 skip controlled by track 1 of VFU 
2 skip controlled by track 2 of VFU 
7 skip controlled by track 7 of VFU 
EXAMPLE: 
seven @ cacerns reese rvcensor LL] 
pie sie 
APS. PROGRAMING FORM 
A 
ee aes oregaron orenanos A 
te sho ols a “ se us i 
ofzto F H ; 
t 


Ht Ho H 
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Primary Instructions 


Primary instructions have a one-to-one correspondence with machine 
language instructions. 


They are written as symbolic expressions. The assembly program 
generates an instruction in machine language for each primary instruction. 


Primary instructions are written according to the rules described in the 
Reference Manuals. 


Primary instructions can be classified according to two criteria: their 
format in store after translation or their format in APS language. 


A description of the primary instructions classified according to their 


internal format is given on pages 116 to 127. A list of the instructions 
grouped according to their APS language format is given on pages 128 ~ 129. 
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a. Type 1 Instructions 


The instruction repertoire consists of fourteen Type 1 instructions: 


Add Decimal AD 
* Add Packed AP 
Subtract Decimal SD 
* Subtract Packed SP 
Move Right Quartets MvQ 
* Move Packed Mvp 
Compare Right Quartets CMQ © 
* Compare Packed CMP 
* Multiply Packed MP 
* Divide Packed DVP 
Add Binary AB 
Subtract Binary sB 
* Pack with Sign PKS 
* Unpack with Sign UPKS (@) 


Type 1 instructions consist of: 
- an operation code 


- an operation complement containing length information 
for each of two operands 


- address references to the rightmost octets of the two Oo 
operands 


The operand length information is obtained either directly 
from the instruction coding (when length specifications 

are entered by the programmer) or from the actual length of 
the data field specified by the operand. 


(*) Applicable for EDOS and ETOS only. 
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EXAMPLE: the card read routine is called and the operation is then 


validated. 
senna @ weerare ipaniciiel 
Sg ha ead 
ieee 
a ae Tpenand 
gag ht 0 
GBOME cn tean 
ac Una HOARE H 
Oo9 TE ryt 
O00 Tot cr a rc 
Hit 
Bo rane tH HY 
To] eGnnnnG C 
ila “HEH tt 
Se i 
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*PRINT 


Print a Line and/or Advance Paper on Printer 


DESCRIPTION: this macro instruction calls the print routine and/or the 
BIOS paper movement and commands its executian. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: *PRINT 


OPERAND: symbolic address of the area containing the required 
parameters for the print operation. 


The parameters, which must be defined by DC instructions, 


are as follows: 


T = 00 to specify paper advance, followed by printout, 
on channel ¢ with non-integrated printer 


where: 


= Of to specify paper advance only, on channel 1 
for non-integrated printer 


=, 10 to specify paper advance, followed by printout, 
with integrated printer 
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= 11 to specify paper advance only, for integrated 
printer 


= 20 to specify paper advance, followed by printout, 
on: channel 3 with non-integrated printer 


= 21 to specify paper advance only, on channel 3 for 
non=integrated printer 


S = any character, for the routine's work functions. 


HOW IT WORKS: the assembler translates this macro instruction into the 


following two instructions: 


JRT 736 

De AL2(PAR) © 
The first instruction jumps to the start address of 
the BIOS print and paper movement routine while the 


second defines the start address of the area containing 
the parameters. 


The information to be printed must be located starting at 
addrese 514 for a length of 160 store positions. 


The value 00 must always be located in store position 
512. o 
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& paper movement code must be placed in store position 513+ 
and can aseume one of the following values: 


0G no paper movement 

01 skip controlled by track t of VEU 
02 skip controlled by track 2 of WU 
03. ekip controhled by track 3 of VFU 
04 skip controlled by track 4 of VET 
05 skip controlled by track 5 of WFU 
06 skip controlled by track 6 of VEE 
CT skip controlled by track 7 of VAT 
OY single line feed 

OA double line feed 

OB triple line feed 

FP set unit to manval (operator call). 


The codes located in positions 512 and 513 must be reset 
after each command, 

At the end of the print operation, the UF/OF and ZE/NZ 
indicators can assume the following configurations: 


10 for normal condition 
11 for end-of-page. 


EXAMPLE: print routine ia called on channel 1, with a non-integrated 
printer, and a triple line feed is executed. 


Mes gcQ20090 | REA 
sere UE oo 
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Type 4 Instructions 


Type 4 instructions operate directly upon the eight index registers 
in Core Store and may only be used under EDOS or ETOS. 


There are six Type 4 instructions: 


Load Register LR 
Add Memory to Register AMR 
Subtract Memory from Register SMR 
Compare Register to Memory CMR 
Store Register sTR 
Load Address LA 


Type 4 instructions consist of: 
~ an operation code 
- an operation complement containing the name of a register, 
directly specified as operand 1, in the three least significant 
bits of its left quartet. 


-an address reference for the rightmost octet of the operand 
in store, except for instruction LA 


These instructions contain no length data since both operands have 
an implicit length of 2 octets. 
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After translation into machine Janguage, each Type 4 instruction occupies 
four octets of store, as follows: 


wwe | se orenanes ql 
ogo Or 

elo 

late tt 

OOomm 1 
slo T 

of eloh rH 

lo 

goo ALTE Tot cI 

lle tr 

alo iat 4it4 

nog 

alata cou 

Asta i cl 

nog 

a rH H 


4 octets no 


Operation Code 
Operand 2 Address 
Operation Complement 
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e. Type5 Instructions 


There are twenty-one Type 5 or Jump instructions in the instruction 
repertoire. 


They can be divided into three categories based on the kind of 
condition tested: 


- these in which the jump execution depends on the condition of 
the Central Processing Unit's internal indicators: 


Jump on Condition JC 

* Jump on Condition and Return JCR 
dump if Equal dE 

* Jump if Equal and Return JER 
dump if Greater JG 

* Jump if Greater and Return JGR 
Jump if Greater or Equal JGE 

* Jump if Greater or Equal and Return JGER 
Jump if Less JL 

* Jump if Less and Return JLR 
Jump if Less or Equal JLE 

* Jump if Less or Equal and Return JLER 
Jump if Not Equal JNE 

* Jump if Not Equal and Return , JNER 


- those in which the jump execution depends on other conditions, 
that is, the presence of an internal error or the condition of 
certain switches on the operator's Control Console: 


Jump on Internal Error JIE 
Jump if Switch 1 Set ISL 
Jump if Switch 2 Set J82 


()Applicable for EDOS and ETOS only 
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- those which specify a jump to be taken regardless of the condition 
of the internal indicators: 


dump Unconditional JU 

Jump Unconditional and Return JRT 

No Jump Nos 
* No Jump and Return NOIR 


Type 5 instructions consist of: 
- an operation code 


+ an operation complement whose left quartet contains 
information about the conditions in a category which are 


to be tested 


- an address reference to the leftmost octet of the instruction 
which is to be executed if the specified condition is satisfied. 


After translation into machine language, each Type 5 instruction 
occupies four octets of store, as follows: 


aoctats [_, me Sea 
“operation Code Beas 

Operation Complement | erent 

= : Te —F 
regi 

HEACGU EHSL tasan anges t 


o 
‘octets 
Operation Code oad 
‘Operation Complement | AYdregs 


(*) | Applicable for EDOS and ETOS only. 
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f. Type 6 Instructions 


There are six Type 6 instructions: 


Halt System Operation HLT 
No Operation NOP2 
Turn OPERATOR CALL Light On LON 
Turn OPERATOR CALL Light Off LOFF 
Enable SINGLE-STOP ENS 
Inhibit SINGLE-STOP INS 


Type 6 instructions consist of: 


- an operation 


- an operation complement 


After translation into machine language, each Type 6 instruction 
occupies two octets of store, as follows: 


‘ume| nase + | oregon : onenanos 


ane ; 
gag ode 

. zy ieaaniattn HEHE 

Es H HH rH FH Ht 
2 octets 


Operation Code 
Operation Complement 
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g- Type 7 Instructions 
There is one Type 7 instruction: 
Call Peripheral PER 
It consists of: 
~ an operation code 
-— an operation complement which contains the name of the 


Peripheral Unit specified for the operation by the first 
operand 


- an address reference to the leftmost octet of the data 
field named by the second operand. 


After translation into machine language, this instruction occupies Oo 
four octets of store, as follows: 


openanos 


cowrin| 


orenaron 
eae 


4 octets 


Operation Code 


Operand 2 


Operation Complement Address 
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h. Type 8 Instructions 


There are two Type 8 instructions, only applicable for EDOS or ETOS: 


Cali Peripheral Indirect PERI 
Load Program Status Register LPSR 


Type 8 instructions consist of: 
- an operation code 


- an address reference to the leftmost octet of the data field 
specified by the operand 


After translation into machine language, each Type 8 instruction 
occupies four octets of store, as follows: 


orenaron openanos 


i 


TSTS1S SS STSTSTEr 


Operation Code 


Operand address. 


The operation complement field is present but unused. 
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Classification of instructions by APS format 


The primary instructions are divided into six groups according 

to how they are written on the APS programming form. Note that 
some of.these instructions may only be used under EDOS or ETOS, 
as specified on the previous pages. 


- First group: function code only 


ENS LON 
INS NOP2 
LOFF HLT 


- Second group: function code and one operand 


JE JER 
JG JGR 
IGE JGER 
JE JLER 
oL JLR 
JLE JNER 
JNE JRT 
JS1 NOIR 
J82 PERI 
Ju LPSR 
Nod 


- Third group: function code and two operands 


The first operand is immediate and the second is an address. 


Jc or 
ICR N 
MVI x 
CMI ™ 
“PER 
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- Fourth group: function code and two operands 


The first operand is the name of an index register; the second 
is an address. 


LA SMR 
LR CMR 
AMR sTR 


- Fifth group: function code and two operands 


The first operand is an address with a length value not greater 
than 256 characters; the second operand is an address. 


Mvc SR 
MC PK 
CMC SL 
oc TR 
XC EDT 
UPK 


- Sixth group: function code and two operands 


Neither operand has length exceeding 16 characters: 


MVP MVQ 
CMP CcMQ 
AP AD 
SP sD 
MP AB 
DVP SB 
PKS 
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3. APS Macro-instructions 


See paragraph ¢. on page 14 for a general description of macro- 
instructions and how to use and translate them. The macro-instructions 
for executing operations of the Central Processing Unit (excluding those 
referring to input/output operations) are divided into two groups: 


- control macro-instructions 
- arithmetic macro-instructions 
a. Control macro-~instructions 
These macro-instructions interrupt the sequential execution of a 
program in order to call a segment (CALL), to make a re-entry 
to the Operating System when program execution has been completed 


(STOP), to make a re-entry to the Operating Program at any point in 
program execution (ABORT), or to call a subroutine (SUB or *N..-.N). 
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CALL 


Call Segment 


DESCRIPTION: Macro-instruction used at any point in the program, to call 
another program segment. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: CALL 
OPERANDS: - OP.1 number of the segmcat to be called 


-OP.2 address from which program execution is 
resumed, after the new segment has been read 
in Core Store. May be expressed by a symbolic 
name or a decimal number in DOS/TOS/DOS IL, 
by a symbolic name only in EDOS/ETOS, 

This operand is optional. 


EXAMPLE: 
GenenaL GD erecrate ‘eeeminicaron race vnaer ELs] 
See nL rr... LOTT 
APS PROGRAWAING FORM (a ae raacain o, be 

7a Pee oreggzow orenanos F 
10} 110) Bee 

OBO TTT 
e[slo 

10 | 4/0] ned 

ooo 

oslo 

of7lo ri o 


NOTE: This instruction may not be used in a Subroutine. 
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NOTES: 


- if operand 2 is a symbolic name, this is introduced into the Entry Table 
by the APS Assembler. 


- the macro-instruction CALL may be written at any point in the program 


- if operand 2 is not used program execution is resumed, after loading 
of the segment called, starting from the instruction following the CALL, 
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STOP 


Stop program and Restart Operating System 


DESCRIPTION: this macro-instruction allows re-entry to the Operating 
System after program execution. 
MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: STOP 


OPERANDS: none 

EXAMPLE: 

senenar@ rcerae reson reensae La] 
7 DOT 0 
c LPH 

se isleirial iy 

i TE iplech | { 
H | 
H I 


NOTE: all programs to be inserted in the organization of the Operating 
System must end with this macro-instruction. 
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suUB 


Call Subroutine 


DESCRIPTION: calls any subroutine present in the library. 
It is normally used in DOS or TOS. DOS IL, EDOS and ETOS 


effect a subroutine call by means of the macro-instruction 
+*N...N (see page 136), but also accept the SUB macro-instruction. 


MACRO-INSTRUCTION FORMAT: 
NAME: any name 


OPERATION CODE: SUB 
OPERAND: subroutine's symbolic name 


HOW IT WORKS: the subroutine called is assembled in the main program 
and the relative addresses are changed to absolute 
addresses. In other words, the actual initial address of 
the subroutine is added to the addresses relative to the 
conventional initial address 00 (hexa.). 


The SUB macro-instruction is translated into a IRT 
instruction which jumps to the actual initial address of the 
assembled subroutine. 


Calling a subroutine usually requires an initial transfer of 
the operands to certain fixed store areas and a subsequent 
transfer of the results. For details on the usage rules, 
which are peculiar to each program, reference should be 
made to the relevant subroutine manuals. 
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EXAMPLE: subroutine YSRRN is called after transfer of the value to be 
operated and subsequent transfer of the result. 


GENERAL GB etectaic rmevmiricarion oi itcoar Lila 

wonemenomowrnann 8 

(Ge 100 senes 

fos orn ree LET 

ry 

une | nase omy oreRanos iF 
oo 7 

ao CMva! nl 

BB Lp eaie i ' HH 4 
ofato viel | | F trelsuiuirh oy ‘ei)| 

elale ' TT 

OOOMmEI i 

ol] H | 

O00 maa i TL 

[olstol [| i 

foto] H 

11 1}9) ! LU 


NOTE: this macro-instruction is also described on page 189. 


It is possible to use subroutines containing transcoding tables; their 
name must consist of six characters, starting and ending with a Y. 


135 


APS REFERENCE MANUAL 


*«N...N 


Call Subroutine with Parameter Definition 


DESCRIPTION: this macro-instruction (only applicable for DOS I, EDOS and 
ETOS) calls a subroutine from the library which may have 
been supplied by the software or by the user. A subroutine 
call by means of this macro-instruction requires a specification 
of the operands as described below. 


MACRO-INSTRUCTION FORMAT: 
NAME: any name 


OPERATION CODE: *N...N (where N...N is the name of a subroutine 
present in the library that does not begin with 
the letter ¥. The name of this subroutine without 

‘ an initial Y must have a length of no more than 
five characters. ) 


OPERANDS: consist of addresses and lengths and are seperated by 
commas. The addresses can be specified in any way. 
The lengths can be omitted depending on the subroutine 
called. The parameters needed to execute the subroutine, 
are found at these addresses. The operands field must 
contain at least one operand. 


HOW fT WORKS: the subroutine called is assembled in the main program 
and the relative addresses are changed to absolute * 
addresses. In other words, the subroutine's actual initial 
address is added to the addresses relative to the 
conventional initial address 0, 
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GENERAL ELECTRIC 


GE - 100 SERIES 
APS PROGRAMMING FORK 


une | wane 


APS REFERENCE MANUAL 


The macro-instruction *N...N is translated into a JRT instruction 
to the initial address of the assembled subroutine. For each 
operand an address-form DC instruction is generated specifying 
the address of the series of parameters required by the 
subroutine. 


For further details see the relevant subroutine manuals. 


lenerircarion: PACE MuuBeR [] 
PROGR ANNIE PROGR RGR] ate] ASOREEEA| 
| iii, 2 


OPERATION mA 
ERAT OPERANOS 


[sconri 


Hn 


7] 
2 
3 
a 
| 
él 


The subroutine YBILL is called. The parameters necessary for its exeuction 
are at the address PARI with length 5 and at address PAR2 with length 2. 
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ABORT 
Process Abort 
DESCRIPTION: This macro-instruction (only applicable for DOS II, EDOS or 
ETOS) causes processing to stop at address 02A6, after setting 
- to NO the ID Sequence Validity Switch. By pressing START, 
control is returned to the Operating System. 
MACRO-INSTRUCTION FORMAT: 
NAME: any name 
OPERATION CODE: ABORT 


OPERANDS: none 


EXAMPLE: 
ey Tore semncnos iecnaa LE) 
ie aaa PROGRAMMER ‘DATE mtorr 
7 ¥ OreRANoS 2 J a 
IZiE| 

Cou HHH 

; 

él rT 

HH 
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Avithmetic macro-instructions 
These macro-instructions cannot be used within a subroutine. 
Operand characteristics 


In addition to the arithmetic instructions in the set of primary 
instructions (see page 116), four additional macro-instructions 
are available, 


- ADS (additional) 

- SDS (subtraction) 

~ MULS (multiplication) 
- DIVS (division) 


The operands are in unpacked, unsigned form. The result can 
occupy the area reserved for one of the operands or another area. 


Operand signs 
To represent the operand signs, the four most significant bits of a 
store position are used conventionally while the four least significant 


bits contain the number's binary value. 


Consequently, the negative numbers have the four most significant 
bits equal to 1010. Therefore: 


-0=1010 0000 
-1=1010 0001 
-2=1010 0010 


-3=1010 0011 


-9=1010 1001 


These store configurations correspond to the characters of the 
graphic set from f to R. 
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The negative numbers ranging from 0 to 9 are, therefore, conventionally 
represented by the following characters: 


-o=? -5=N 
-leg -6=0 
-2=K -T=P 
-3=L -8=Q 
-42™ -9=R 


The numbers with the four most significant bits equal to 0100 are 
positive. Therefore: 

+0 = 90100 ‘0000 

+1=0100 0001 

+2= 0100 0010 


+9=0100 1001 


A number made up of several figures is considered negative when its 
least significant figure is negative. Therefore, the number -952 is 
represented in store as 95K. 


Since positive numbers are indicated conventionally with the left 
quartet 0100 corresponding to the normal left quartet of the unsigned 
numbers, it is clear that these macro-instructions can also be used 
for unsigned numbers, since the latter are processed as if they were 
signed positively. 
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Operand lengths 


Operand lengths are variable but must not exceed a certain limit, 
which varies according to the type of macro-instruction. 


Operand lengths are controlled by the assembly program and if they 
do not conform to the rules, the operand error signal is given. 


The following table indicates the maximum length of operands and 
result for each macro-instruction, 


ist Operand 


2nd Operand 


Result 


Macro-instruction format: ADS, SDS, MULS, DIVS 
NAME; any name 
OPERATION CODE: ADS for addition 
SDS for subtraction 


MULS for multiplication 
Divs _ for division, 
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the maximum number of operands is four. 
The first three must always be expressed by a 
symbolic name. Their meanings are as follows: 


- OP. 1 first term of the operation (addendum, 
minuend, multiplicand, dividend) 


- OP, 2 second term of the operation (addendum; 
subtrahend, multiplier, divisor) 


- OP. 3 result 


- OP. 4 consists of SH = followed by a decimal 
number ranging from 0 to 15 that indicates the 
number of shifts to be executed on the result, In 
other words, the result is shifted to the right 
Qosing digits) by as many positions as are indicated, 


If, after this operation, the result has a length less 
than that expected, it will be completed with zeroes 
to the left. If the number of shifts indicated is more 
than 15, there is an operand error signal. 


Some of these operands may be unused. By calling 
A, B, and C the first, second, and third operands, 
the following configurations are possible: 


-A, B, C, SH=XX 
-A, B,C 


shifting of the resuli is not required 
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-A,B 
it is considered like A,B, A 
- A, B, SH = XX 


it is considered as A,B, A, SH = XX 


Translation of macro-instructions 


The arithmetic macro-instructions are translated as follows: 


JRT 
De 
pe 
be 
DC 
De 


appropriate subroutine call (main subroutine) 

AL 3 (A) 

AL 8 (B) 

AL 3 (C)- 

AL 1 (value of the shift), if in DOS II, EDOS or ETOS 
AL 1 (234 - value of the shift), if in DOS or TOS 


Type A (binary) DC instructions with expressed length 3 are translated 
with the length and address of the field indicated in parentheses. In 
this case, the first three DC instructions are translated respectively 
with the length and address of the first operand (A), the second operand 
(B), and the result (C). 


DOS or TOS, the result is always located in a Core area, with rightmost 
address 234 (decimal), 
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Main subroutines make use of secondary subroutines in the sense that 
certain operations common to some or all of the main subroutines are 
executed by the secondary subroutines themselves. As a result, there 
is an obvious saving of storage if several main subroutines should be 

called, 


The secondary subroutines are: 


~ YYLOAD 
- YYEX 

- YYSIGN 
- YYADS 


Input/Output Macro-instructions 
See page 14 for a general] description of these macro-instructions, their 


use, and their translation. 


Input/Output macro-instructions use subroutines and routines that control 
input/output files, These subroutines and routines make up the Input/Output 
Systems described in detail in Part I. 

These macro-instructions are: 


- BIOS macro-instructions 


The following table shows the names of the macro-instructions with an 
indication of the relevant Operating Systems. 
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BIOS Macro~Instruction: 


Operating Systems 


TOS | DOS I EDOS ETOS 


* READ 
* VCR 

* PRINT 
* VPR * * * 
* LESS 

* MTAPE 
* VMT 

* TAPE * * * 
* MDISC 
* VDS 

* DISC * * 
* IODC 

* MSG 

* OSDS 
* PAUSE 
* STAND * 


See RR HH 


ee HK 


ee 


EIOS macro-instructions 
These macro-instructions cannot be used within a subroutine. 


« card files (EDOS and ETOS only) 
OPEN = Open File 
GET = Read Card 
RLS = Close Operation on Card Reader 
CLOSE= Close File 

« print files (EDOS and ETOS only) 
OPEN = Open File 
PUT = Print Record 
RLS = Close Operation on Printer 
SKIP = Paper Skip 
CLOSE= Close File 
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« tape files 


OPEN 
GET 
PUT 
NEXT 
CHKP 
RLS 
CLOSE 


OPEN 
GET 
FIND 
PUT 
PUTX 
DEL 
SEEK 
DCKP 
COPY 
NEXT 
CLOSE 


~ input/output subroutine macro-instructions: 


Open File 

Read Record 

Write Record 

Change Volume 
Write Checkpoint 
Pass to New Block 
Close Volume or File 


dise files (except in ETOS) 


Open File 

Read Record 
Find Record 
Write Record 
Update Record 
Delete Record 
Position Heads 
Write Checkpoint 
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Copy Index Cylinder (MOS II and EDOS only) 


Change Volume 
Close Volme or File 


SUB Call Subroutine 
*N..N Command Peripheral Operation (DOS Il, EDOS and ETOS only) 
**N..N Validate Peripheral Operation (EDOS and ETOS only) 
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I. INPUT/OUTPUT SYSTEMS 


A. GENERAL INFORMATION 


Input/output systems consist of routines and subroutines which control 
and check operations on data files that are read into or from Core Store. 


Input/output systems are made up of BIOS (Basic Input/Output System), 
EIOS (Extended Input/Output System), and the Input/Output Subroutines. 


The peripheral units that are handled by EIOS and BIOS are also called 
"basic units" of the system. 


For units in excess of the "basic units", and also for some particular 
Operations (not covered by EIOS) on the "basic units", the Input/Output 
Subroutines are used. 


The type and number of the basic units vary in accordance with the Operating 
System is use, as shown in the appropriate Operating System manuals. 


NOTE: to use the input/output systems, one should be familiar with the 


organization of card, print, magnetic tape and magnetic disc files 
as described in the "Data File Organization Manuai". 
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BIOS (BASIC INPUT/QUTPUT_ SYSTEM) 


BIOS (Basic Input/Output System) is used to physically process information 
concerning the system's basic peripheral units by reading a card or a 
block on magnetic tape, ete. EJOS transfers control to BIOS whenever 
physical record processing is required, 


BIOS consists of a series of routines, each of which controls a given 
peripheral. It is part of the supervisor and is always located in store 
during operation of the system. 


BIOS permits overlapping of I/O operations, as provided for by the system 
hardware, as well as processing of non-standard files. Its routines can be 
called by two types of macro-instructions: Command for the execution of 
peripheral operations, and Validation, for the execution of error, end-of-file, 
and unit-out-of service tests, ete. 


The BIOS macro-instructions are as follows (for information on their usage 
see the table om page 145): 


« for card reading 


*READ Read Card 
*VCR Validate Card Reading 


« for printing 


*PRINT Print Line and/or Advance Paper on Printer 
*VPR Validate Print Operation 


e for reading and printing 


*LBSS Read Card and Print 
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e magnetic tape read/write 


+*MTAPE Operate Magnetic Tape Unit 
*VMT Validate Tape Operation 
4*TAPE Operate and Validate Magnetic Tape Unit 


» magnetic dise read/write 


*MDISC Operate Dise Unit 
+*VDS Validate Disc Operation 
#*DISC Operate and Validate Dise Unit 


A detailed description of these macro-instructions is given on the 
following pages. 


Additional macro~instructions are available which are however reserved 
for use by EDOS or DOS II not by the programmer. They will not therefore 
be described, but only listed below: 


¥IODC Input/Output Dise Check 
+*MSG Message 
#OSDS Operating System Dise Subroutine 


*PAUSE Pause on Error Condition 
*STAND Order Card Standardization 
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*READ 

Read a Card 

DESCRIPTION: this macro-instruction (applicable for EDOS and ETOS only) 
calls the BIOS card read routine and commands its execution. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: *READ 


OPERAND: symbolic address of the area containing the parameters 
required for the read operation. 


The parameters, which must be defined by DC instructions,- 


are as follows: 


where: 


T = 00 if the card is to be read on channel 1 

= 20 if the card is to be read on channel 3 
L = number of characters to be read, less i 
It = address of the read area. 
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HOW IT WORKS: the assembler translates this macro-instruction into the 
following two instructions: 
JRT 728 
DCG AL2(PAR) 
The first instruction jumps to the initial address of the 


BIOS card read routine while the second defines the initia! 
address of the area containing the parameters. 


EXAMPLE: the routine is called to read on channel 1 a card with Jength 
80 into the area FIELD. 
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*VCR 
Validate Card Reading 


DESCRIPTION: this macro-instruction is for validation of card reading, 
previously commanded by the *READ macro-instruction. 


MACRO-INSTRUCTION FORMAT: 
NAME: any name 
OPERATION CODE: *VCR 
OPERAND: symbolic address of the area containing the parameters 


required for the read operation. These parameters are 
the same as those for the *READ macro-insiruction. 


HOW IT WORKS: the assmebler translates this macro-instruction into the 
following two instructions: 


JRT 732 
DC AL2(PAR) 


The first instruction jumps to the BIOS read validation 
routine while the second defines the initial address of the 
area containing the parameters. 


At the end of validation, the UF/OF and ZE/NZ indicators 
can be set as follows: 


10 operation validated 
01 end-of-file. 
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EXAMPLE: the card read routine is called and the operation is then 
validated. 
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*PRINT 


Print a Line and/or Advance Paper on Printer 


DESCRIPTION: This macro-instruction (applicable for EDOS and ETOS only) 
calls the BIOS print and/or paper advance routine and commands 
its execution. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 

OPERATION CODE: *PREINT 

OPERAND: symbolic address of the area containing the required 
parameters for the print operation. 


The parameters, which must be defined by DC instructions, 
are as follows: 


where where: 
T = 00 to specify paper advance, followed by printout, 
on channel 1 for non-integrated printer 


= 01 to specify paper advance only, on channel 1 
for non-integrated printer 


= 10 to specify paper advance, followed by printout, 
on channel 2 for integrated printer 
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= 11 to specify paper advance only on channels 2, 
for integrated printer 


= 20 to specify paper advance, followed by printout, 
on channel $ for non-integrated printer 


= 21 to specify paper advance only, on channel 3 for 
non-integrated printer 


= 50 to specify paper advance, followed by CMC7 
Pprintout,either on channel 1 for non-integrated printer 
or channel 2 for integrated printer. 


= 51 to specify paper advance, without CMC7 printout 
either on channel 1 for non~integrated printer or 
channel 2 for integrated printer 


= 70 to specify paper advance followed by CMC7 
printout, on channel 3 for non-integrated printer 


= 71 to specify paper advance, without CMC7 printout 
on channel 3 for non-integrated printer. 
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T = 00 to 21 applies to all printers, including CMC7 
printers for normal printing only 


T =50 to 71 applies to CMC7 printers, for paper 
advance and CMC7 printing 


S = one-octet area used by the macro-instruction to 
provide the programmer on re-entry to the main 
program, with specific information concerning 
the printing forms, namely: 


00 no indication 

01 end of form 1, or of the only form 
02 end of form 2 

03 end of both forms 


HOW IT WORKS: the assembler translates this macro-instruction into the 
following two instructions: 


JRT 736 

DC AL2(PAR) 
The first instruction jumps to the initial address of the BIOS 
print and paper advance routine while the second defines the 
initial address of the area containing the parameters. 


The information to he printed must be located starting at 
address 514 for a length of 160 store positions, 
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The store locations 512 and 513 must receive the paper 
advance codes, for paper drive 2 and 1 respectively, as 
follows: 


00 no paper movement 

01 skip controlled by track 1 of VFU loop 
02 skip controlled by track 2 of VFU loop 
03 skip controlled by track 3 of VFU loop 
04 skip controlled by track 4 of VFU loop 
05 skip controlled by track 5 of VFU loop 
06 skip controlled by track 6 of VFU loop 
07 skip controlled by track 7 of VFU loop 
09 single line feed 

OA double line feed 

OB triple line feed 

FF set unit to stand-by (operator call). 


The codes in locations 512 and 513 must be reset after each 
command, 


At the end of the print operation, the UF/OF and ZE/NZ 
indicators can assume the following configurations: 


10 for normal condition 
11 for end-of-page 


EXAMPLE: print routine is called on channel 1, for a non-integrated printer, 
and a triple line feed is executed on paper drive 1. 
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*VPR 
Validate Print Operation 
DESCRIPTION: this macro-instruction (only applicable for EDOS and ETOS) 
is used to validate the print operation previously commanded 
by the *PRINT macro-instruction. It is not necessary when the 
*PRINT macro-instruction is used for paper movement only. 
MACRO-INSTRUCTION FORMAT: 
NAME: any name 
OPERATION CODE: *VPR 
OPERAND: the symbolic address of the area containing the parameters 


required for the print operation. These parameters are the 
same as those for the *PRINT macro-instruction. 


HOW IT WORKS: the assembler translates this macro-instruction into the 
following two instructions: 


JRT 740 
DC AL2 (PAR) 


The first instruction jumps to the print validation routine 
while the second defines the initial address of the area 
containing the parameters, 
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At the end of validation, the UF/OF and ZE/NZ indicators can assume 
the following configurations: 


10 for operation validated 
00 print error 
01 unit out of service. 


EXAMPLE: the print routine is called and the operation is then validated. 
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*LBSS 


Read Card and Print 
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DESCRIPTION: _ this macro-instruction calls the routine that will execute 
card read and print operations simultaneously, read only 
or print only, on all PRT100-130 printers and on the 
PRT140-160 printers that do not use the second paper drive 
and do not print CMC7 characters (in these cases the 
subroutine YLB28 is required, as described in the Subroutines 
Manuals). 


The macro-instruction *LBSS is normally used under DOS, 
TOS or DOS II. EDOS and ETOS use the macro-instructions: 
*READ and *VCR to read a card and +PRINT and 

¥*VPR to print a line, but also accept the macro-instruction 
*LBSS. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 


OPERATION CODE: *LBSS 


OPERAND : 


symbolic address of the area containing the parameters 
required for the operation. 


These parameters, which must be defined by DC instructions, 
are as follows: 


T{[Lyi! 8 
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where: 


T = Type of operation, expressed in hexadecimal as follows: 


00 for simultaneous read and print 
01 for print only 

02 for read only 

03 for paper advance only 


L = length of card read area, minus 1, in binary 
Il = address of the card read area, in binary 


S = type of paper advance. It can assume the following 
hexadecimal values: 


00 = set unit to stand-by (only applicable for integrated 

printer) 
01 = skip controlled by track 1 of VFU loop 
02 = skip controlled by track 2 of VFU loop 
03 = skip controlled by track 3 of VFU loop (600,800 or 1100 ipm only) 
04 = skip controlled by track 4 of VFU loop " tee tt 
05 = skip controlled by track 5 of VFU loop " wo Ue et 
06 = skip controlled by track 6 of VFU loop " ps <P 
07 = skip controlled by track 7 of VFU loop " LES al GUE ett 
08 = no paper advance (800 and 1100 Ipm only) 
09 = single line feed 
OA= double line feed 
OB= triple line feed 


For print only operations it is sufficient to specify parameter T. 
Parameters L, I and § may have any value. 
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HOW If WORKS: the assembler translates this macro-instruction into the 
following two instructions: 


JRT 108 
DC AL2(PAR) 


The first instruction jumps to the start address of the card 
read and print routine while the second defines the initial 
address of the area containing the parameters. 


The information to be printed must be located starting at Oo 
address 514 for a length of 160 store positions. 


Upon re-entry from the subroutine, the UF/OF and ZE/NZ 
indicators can assume the following configurations: 


- if read and print 


01 end-of-cards *] 
00 print error 
10 operation executed correctly 


These configurations are mutuaily exclusive. For example, 
in the event of end-of-cards, printing is not executed. 


- if print only ) 
00 print error 
10 operation executed correctly 


~ iffor read only 


01 end-of-cards 
10 operation executed correctly 


- paper movement 


11 end-of-form signal detected before starting the paper 
movement is executed anyway. 


10 otherwise 
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Call subroutine to simultaneously read and print. The card read 
area is located at decimal address 5500 and the length of reading 
is 80 characters. Printing must be executed with a skip controlled 
by track 2 of the VFU loop. 


ee ee 
Por Per ee ee 
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*MTAPE 

Operate Magnetic Tape Unit 

DESCRIPTION: this macro-instruction (only applicable for EDOS and ETOS) 
calls the magnetic tape processing routine used for reading, 
writing, rewinding and erasing tapes etc. 

MACRO-INSTRUCTION FORMAT: 


NAME: any name 

OPERATION CODE: *MTAPE 

OPERAND: symbolic address of the area containing the parameters 
required for the operation. 


The parameters, which must be defined by DC instructions, 
are as follows: 


BOD bind Dees RE [e] 
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T=90 if an operation is required on channel 1 

=2 if an operation is required on channel 3 
t =0 read block forward 

=1 backspace one block 

=2 write block 

=3 rewind 

=4 erase 

=5 rewind and set unit to standby 

=7 read block backward 


For t=3, 4, and5, the channel is not considered. 


LL=length of reading or writing 


Il = binary address of sending or receiving field in Core Store. 


BBBBB = field for block counting if the blocks are numbered 
U = select number of tape unit concerned (from 1 to 8) 


P = indicates the type of vertical parity check provided for 
in reading or writing: 
O for even parity 
P for odd parity 

D =indieates recording density: 


K for a density of 1600 bpi 
L for a density of 800 bpi 
Mfor a density of 556 bpi 
N for a density of 200 bpi 
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EE = binary address of a routine, if any, to be executed in case 
of error. This user-supplied routine is started, when an 
error is detected, by the command phase of operations not 
involving a data transfer, or by the validation phase of a 
data transfer operation. 
if this routine is not available (EE = 0) an HLT instruction 
is executed. 


O = 00 for reading and writing unnumbered blocks 


= 01 for reading and writing numbered blocks 


= 02 for reading unnumbered blocks, with packing (this is 
always done on channel 1) 


= 03 for reading or writing the first block of a reel 
= 04 for writing a tape mark. 


HOW If WORKS: the assembler translates this macro-instruction into the 
following two instructions: 


IRT 720 
DC AL2(PAR) 
The first instruction jumps to the start address of the 


BIOS tape routine while the second defines the start 
address of the area containing the parameters. 


if when rewinding or erasing (parameter t = 3 or 4) the 
unit out-of-ser vice condition occurs, the routine jumps 

to the address expressed in parameter EE (with UF/OF =1 
and ZE/NZ = 0). 
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EXAMPLE: the subroutine is called to write a tape block on channel 1. 
The other features of the operation are: an unnumbered block 
300 characters in length, located at address 5000, use of tape 
unit 2, even vertical parity, density of 556 bpi, and no error 


routine. 
GENERAL GB etectauc iobranesteil Prey ke | 
a>5 pmocnaive Pom Rese ———————reauee. Ld 1 
coe | nme ] oreggpoe OreRanos ; 
oh rt ratte or a cot “ ; “« ai 
z Ld 
Ke a 
IRL 1G5)0101 
LS) 
ciarogat i C 
te FO T 
: L| 
Er To 


167 


APS REFERENCE MANUAL 


¥VMT 


Validate Tape Operation 


DESCRIPTION: this macro-instruction (only applicable for EDOS and ETOS) 
is used to validate a tape operation, previously commanded 
by the *MTAPE macro-instruction. It must be used after the 
block read, write, read backward and backspace operations. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: *VMT 


OPERAND: symbolic address of the area containing the necessary 
parameters for the magnetic tape operation. These parameters 
are the same as those for the *MTAPE macro-instruction. 


HOW IT WORKS: the assembler translates this macro-instruction into the 
following two instructions: 


JRT 724 
DC AL2(PAR) 
The first instruction jumps to the BIOS validate tape 


operation routine while the second defines the initial 
address of the area containing the parameters. 
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At the end of the validation, the UF/OF and ZE/NZ indicators can 
assume the following configurations: 


10 operation validated 
11 tape mark detected during read or backspace 
01 end of medium during write operation 


If an error is detected during the validation routine, the program 
jumps to the address established by the parameter EE # 0. Then the 
configurations are as follows: 


10 unit-out-of-service 

11 block number error (during forward or backward reading 
of numbered blocks) 

01 persistent read or write error. 


EXAMPLE: the magnetic tape routine is called and the operation ia then 
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*TAPE 


Operate and Validate Magnetic Tape Unit 


DESCRIPTION: this macro-instrution calls the magnetic tape processing 
routine and the subsequent validation of the operation. The 
*TAPE is normally used under DOS, TOS or DOS I. EDOS 
and ETOS use the macro-instructions *MTAPE and *VMT 
to read/write on tape, but also accept the macro-instruction 
*TAPE. 

Its use is equivalent to the use of the *MTAPE followed by 

the *VMT macro-instruction for tape read, read backward, 
write, and backspace operations (parameter t = 0, 7, 2, 1). 
When rewinding, erasing, rewinding with unit set to standby 
(parameter t = 3,4,5), the use of the *TAPE macro-instruction 
is equivalent to the execution of the *MTAPE macro-instruction 
without validation. 


It should be noted that the read backward operation cannot be 
executed by means of the *TAPE in DOS, TOS or DOS Il. In 
this case the YBERD subroutine is required (see Subroutines 
Manuals). 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 

OPERATION CODE: *TAPE 

OPERAND: the symbolic address of the area containing the required 
parameters for the operation. 


For a description of the parameters required by the *TAPE 
macro-instruction, see description of *MTAPE, on page 164. 
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HOW IT WORKS: the assembler translates this macro-instruction into the 
following two instructions: 


JRT 104 
DC AL2(PAR) 


The first instruction jumps to the start address of the BIOS 
tape routine while the second defines the start address of the 
area containing the parameters. 


At the end of the tape operation, the indicator conditions are 
the same as those described for the *MTAPE and *VMT 
macro-instructions. 
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*MDISC 


Operate Disc Unit 


DESCRIPTION: this macro-instruction (applicable for EDOS only) calls in the 
disc routine, for the read, write, verify operations, etc. 


MACRO-INSTRUCTION FORMAT; 


NAME: any name 
OPERATION CODE: *MDISC 


OPERAND: symbolic name of the field in Core Store containing the 
parameters specifying the operation. These parameters 
are defined by DC instructions and are formatted as 
follows: 


T ea ee rf) ,2)7,2| oF F fe 2] | 
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Operations Recording mode and channel used 


6 bits/ch.1 8 bits/ch.1 8 bits/ch. 3 


Read 


Read, after 
return to 
reference 
position 


Write, after 
return to 
reference 
position 


Write and verify 


Write and verify, 
after return to 
reference position 


Verify 


Verify, after 
return to 
reference 
position 


Position read/ 


write heads 00 (fixed value) 


Position read/ 
write heads, after 
return to reference 
position 


01 (fixed value) 


Operator call OF (fixed value) 


Figure 6, Permissible hexadecimal configurations of parameter 
T in *MDISC 
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where: 
= Operation to be executed. The codes for the various operations 


are shown in figure 6 on page 173. 
Note that the two verify commands may only be used after 


validating a write operation. 


LL= Page length, minus 1 (in binary) 
O = Address of input. or output field in Core Store (in binary). 


BBBBB = Decimal address of sector where transfer operation must 
start, (from 00000 to 19999 on DSS161, from 00000 to 03999 
on DSS110). In head positioning operations, the three leftmost 
characters only are significant. 

U = logical number of disc unit (from 0 to 9 and A to F). 

FF = Decimal number (in packed signed form) of the last cylinder 
involved in the operation (from 000 to 199 on DSS161, from 
000 to 039 on DSS110). 

EE = Binary address of error routine, if any, to be started when 
the UF/OF and ZE/NZ indicators signal error conditions, 
This user-developed routine is started by the command phase 
of the operations not involving a data transfer, or by the 
validation phase of a data transfer operation. If this routine 
is not provided (EE=0), errors cause processing to stop on 
a HLT instruction, 


O= Not significant. 


HOW IT WORKS: The macro-instruction is translated by the assembly program 
into the following instructions: 


SRT 744 
DC AL2(PAR) 
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The first instruction causes a program jump to the initial address of 
the BIOS disc routine. The second instruction defines the field containing 
the parameters, 


Note that the validation macro-instruction must not be issued, in a head 
positioning or operator call operation, The Command phase of a data 
transfer instruction does not supply any indications as to the result of 
the operation so it must be followed by the Validation phase to test 

the conditions generated. 


EXAMPLE: Call the dise routine to read a page on channel 1, from dise unit 2. 
The operation is further specified as follows: 8-bit recording mode, 
input area in Core Store located at address 5000, page length is 300 
octets, read start address on disc is sector zero, track zero and 
cylinder 100, last cylinder involved in operation is 105. Error 
routine located at address 10, 000, 
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*VDS 


Validate Dise Operation 


DESCRIPTION: this macro-instruction (applicable for EDOS only) is always 
used after an *MDISC macro-instruction to validate the read, 
write or verify operation, i.e. any operation involving a data 
transfer. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: *VDS 


OPERAND: symbolic name of the field in Core Store containing the 
parameters specifying the Operation. These are defined 
by DC instructions and are the same as for *MDISC 
(see above). 


HOW IT WORKS: The macro-instruction is translated by the Assembly program 
into the following instructions: 


JRT 748 
DC AL2(PAR) 


The first instruction causes a program jump to the initial 
address of the BIOS validation routine. The second instruction 
defines the field containing the parameters (see page 172). 

At the end of Validation, if the Command operation was 
successful, control of processing returns to the program, 
register 7 contains the address in Core Store, plus one, of 
the last character transferred, and the field BBBBB in the 
parameters area contains the dise address, plus one, of the 
last sector involved in the operation. 
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If the Command operation was not successful, five more 
attempts are made. If they also fail, an error routine 
(see parameter EE) is entered, the field BBBBB is not 
modified and the UF/OF and ZE/NZ indicators are set as 
follows: 


OF NZ 


0 out of service 
1 positioning error 
1 persistent error, 


orPR 


If the error routine is not available (EE = Zero); errors 
cause processing to stop on HLT instructions. 


If, during the Command phase, the data transfer is not 
complete at the end of the last cylinder (specified by FF), 

@) the excess characters are not transferred, the validation 
routine gives control back to the program, and the UF/OF, 
ZE/NZ indicators are set to 0,1. Register 7 contains the 
address, plus one, of the last character that has been 
transferred. Previous contents of Core Store locations 
224 and 232 to 239 are destroyed. 


EXAMPLE: Call disc routine, then validate operation. 


\e) 


Genenat QD cuectarc 


GE~ 100 SERIES, 
APS PROGRAMMING FORM, 


| 
ume) name OPERANDS H 
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*DISC 


Operate and Validate Disc Unit 


DESCRIPTION: this macro-instruction is used to execute both the command 
and validation phase of a dise operation. The *DISC is normally 
used under DOS, TOS or DOS I. EDOS uses the macro- 
instructions *MDISC and *VDS to read/write on disc, but also 
accepts the macro~instruction *DISC. 


The *DISC combines the functions of the *MDISC and *VDS when 
validation is required. [If *DISC is used for head positioning 
and operator call operations, it results in the command phase 


only. 
MACRO-INSTRUCTION FORMAT 
NAME: any name 


OPERATION CODE: *DISC 


OPERAND: symbolic name of the field in Core Store containing the 
parameters that specify the operation. 


The parameters required in EDOS or DOS I are described 
under the *MDISC, while those required in DOS or TOS 
are as follows: 


Pao 
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where: 


T = Hexadecimal value specifying Operation to be executed, as 
follows: 


00 Read after positioning of read/write heads 

01 Read without positioning of read/write heads 
(operation requested after either operator "T=00" or 
"P=41") 

02 Write and verify 

04 Write (do not verify) 

06 Verify 

08 Operator Call 


LL = Page length (in binary) minus 1. 


1 = Address (in decimal) of sector where transfer operation 
must start (from 00000 to 19999). In head positioning 
operations, the three leftmost characters only are 
significant. 


= Logical number of dise unit (from 0 to 9) 


a 
w 


a) 
" 


Can assume one of the following hexadecimal values: 


40 if positioning and transfer operation 

41 if positioning only (in this case the value of T is 
disregarded) 

50 if positioning and transfer operation, after return 
to reference position. 

51 if positioning only, after return to reference position 
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D = Code (00 to 0F hexadecimal) specifying transfer mode, as 
+ shown in figure 7. 


Par, TRANSFER MODES 
D Sector Information Recording| Character 
Sequence | to be recorded mode format 
Check (6/8 bits) 
00 Yes data sector 6 
OL Yes data sector 8 
02 Yes data full track 6 
03 Yes data full track 8 
04 Yes headers sector 6 
05 Yes headers sector 8 
06 Yes headers full track 6 
07 Yes headers full track 8 
08 no data sector 6 
09 no data sector 8 
OA no data full track 6 
0B | no data. full track 8 
0c no headers sector 6 
oD no headers sector 8 
0E no headers full track 6 
OF | no headers full track 8 
LL 


Figure 7. Permissible hexadecimal configurations of 
Parameter D in *DISC. 


EE = Rinary address of error routine, if any, provided by user 
for checking of errors, as detected by testing the UF/OF and 
ZE/NZ indicators. If this routine is not provided (EE= 9), 
errors cause processing to stop on a BIos’HLT instruction. 


O = Not significant 
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The assembler translates this macro-instruction into the 
following two instructions: 


JRT 120 
DG AL2(PAR) 


The first instruction jumps to the start address of the BIOS 
dise routine which the second defines the initial address of 
the area containing the parameters, 


call routine for reading a page from disc unit 2, The operation 
is further specified as follows: pages recorded in 8-bit format, 
input area in Core Store located at address 5000, page length 
is 300 octets, read start address on disc is sector zero, track 
zero and cylinder 100, last cylinder involved in operation is 
105. No error routine is provided. 


foewrincarion 


| 


Pace nuuacr 
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oresaron OreRanos 


ny 
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a 
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C. EIOS (EXTENDED INPUT/OUTPUT SYSTEM) 


The command and check operations on the input/output files, required 
by the use of the basic peripheral units, are executed by a series of 
subroutines that make up the Extended Input/Output System (EIOS). 


EIOS is a group of closely connected subroutines which process information 
both physically and logically. The physical processing is carried out 
with the help of the BIOS routines. 


The subroutines making up EJOS are written, together with other subroutines, 
in the subroutine library and are used by means of the appropriate APS 
language macro-instructions, called input/output macro-instructions, after 

the files to be processed have been defined by the FILE declarative instructions. 


EIOS macro-instructions may not be used within a subroutine, 


The input/output macro-instructions are divided into four groups according 
to the type of peripheral unit used by the file to be processed: 


a. macro-instructions for processing card files (applicable for EDOS 
and ETOS only, see page 196 to 202 ), For each read request 
made by the main program, the subroutine called by the macro- 
instruction reads a card in the Block Area and starts the reading 
of the next card. This permits the use of overlapping as provided 
by the system's hardware. 


b. macro-instructions for processing print files (applicable for EDOS 
and ETOS only, see page 203 to 210. These macro-instructions are 
also designed to permit the overlapping as provided by the system's 
hardware. 
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macro-instructions for processing magnetic tape files (pages 211 to 228) 
For each read request made by the main program, the subroutine 
ealled by the macro-instruction makes a record available, as follows: 


- if the file is organized in blocks consisting of a single record, 
the record is supplied in the Block Area 


~ if the file is organized in blocks consisting of two or more records, 
there are two cases: 


« if provision was made in the FILE instruction for using the 
Work Area, the record is supplied in this area 


« if provision was made in the FILE instruction for using an 
index register, the address of the record located in the Block 
Area is placed in the register (only applicable for EDOS/ETOS). 


For each write request made by the main program the subroutine 
considers the logical record to be written, ag follows: 


~ if the file is organized in blocks consisting of a single record, 
the record in the Block Area is written on tape 


~ if the file is organized in blocks consisting of two or more 
records, there are two cases: 


« if provision was made in the FILE instruction for using 
the Work Area, the record in the Work Area is transferred 
to the Block Area 


« if provision was made in the FILE instruction for using an 


index register, the record whose address is in the register 
is transferred to the Block Area (only applicable for EDOS/ETOS), 
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d. macro-instructions for processing disc files (page 229 to 272). 
The main functions of EIOS are: 


~ for Input files (reading) . 


« sequential or random -sequential reading of a sequential file, 
possibly with chaining of records in overflow area (page 236) 


e random reading of a sequential file (page 238). 

« random reading of a random file (page 242). 
~ for Output file (recording) 

« recording (generation) of a sequential file (page 249). 
- for Updating file (inserting new records) 


« inserting records in overflow area of sequential file, by 
sequential or random-sequential processing (page 251). 


« inserting records in sequential file, by random processing 
(page 252). 


« inserting records in random file, by random processing 
(page 254). 


« inserting records in empty file, by random processing 
(sub~case of previous operating mode, inserting records in 
random file) 


- for Updating files (replacing or deleting records) 
« replacing records in sequential or random file, by sequential 
random-sequential, or random processing (page 256). 


« deleting records in sequential or random file, by sequential, 
random-sequential, or random processing (page 258). 
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A sequential file may be processed at different times, in 
sequential, random-sequential, or random mode. It should be 
noted that, if some records in a sequential file have previously - 
been deleted by the macro-instruction DEL, that file can still 

be processed sequentially or random -sequentially ; random 
processing of that file will also be possible, provided any 
insertion of records after deletion will have been accomplished 
in random mode. 


The chart in figure 8 contains a summary of the main EIOS 
functions and for each of them shows the associated macro- 
instructions and the record addressing methods, as required. 
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ADDRESSING METHODS (A.M.): - 


= Record Addressing (Direct Addressing) 
Addressing by page 
=Addressing by pair of tracks, in DOS I/EDOS 
Addressing by track, in DOS/TOS 
4 =Addressing by pair of tracks and volume in DOS II/EDOS 
Addressing by track and cylinder, in DOS/TOS 
5 =Addressing by File Index 


1 
2 
3 
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INPUT/OUTPUT SUBROUTINES 


Input/Output Operations on peripheral units in excess of the basic ones, 
and also some particular operations (not covered by EIOS) on the basic 
units, are handled by a set of input/output subroutines included in the 
software or written by the user, which are located in the subroutine 
library. 


These subroutines are called by the following macro-instructions: 


SUB Call Subroutine 
*N..N Command Peripheral Operation 
*4#N..N Validate Peripheral Operation (EDOS/ETOS only) 


A large part of the input/output subroutines consists of two phases: 

the Command phase which carries out a peripheral operation (for 
example, read a card, write a block on tape), and the Validation phase 
which performs some test on the previous operation (for example, error 
test, end-of-file and out-of-service tests). 


The Command phase is called by the macro-instruction *N..N, while the 
Validation phase is called by the macro-instruction **N..N. 
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SUB 


Call Subroutine 


DESCRIPTION: this macro-instruction is used to call a subroutine present 
in the library which is to be used to control a peripheral 
unit, 


It is normally used in DOS or TOS. 

DOS, EDOS and ETOS call an 1/0 subroutine by means of the 
macro-instructions *N..N and **N,.N, but also accept the 
SUB macro-instruction. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: SUB 
OPERAND: symbolic name of subroutine 


HOW If WORKS: the subroutine called is assembled in the main program and 
its relative addresses are changed to absolute addresses. 
In other words, the subroutine's actual initial address is 
added to the addresses relative to the conventional initial 
address 0. The SUB macro-instruction is translated into 
a JRT instruction that jumps to the assembled subroutine's 
initial address, 


For details on the usage rules, which are peculiar to each 
program, reference should be made to the relevant subroutine 
manuals, 
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NOTE: It is possible to use subroutines that contain transcoding tables: their 
name must consist of six characters, starting and ending with a Y. 


EXAMPLE: Call subroutine YABCD 


ernest Pace muuner C] 
PROGR NE ‘pROGRMUER | DATE] ~~ 
ferirae reco | rrr, 


J 
H 
LI 


dat Hae anna 
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+N. .N 


Command Peripheral Operation 


DESCRIPTION: this macro-instruction (applicable for DOS II, EDOS and 
ETOS only) is used to call a library subroutine for handling 
of a peripheral unit. For subroutines consisting of Command 

» and Validation phases, this macro-instruction executes the 
Command phase only. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 


OPERATION CODE: *N..N (N..Nis the name of a subroutine present 
in the library without the initial letter Y; The 
Subroutine name without the letter Y must have a 
maximum length of four characters). 


OPERANDS: they consist of addresses (and lengths) and are separated 
by the commas. The addresses can be specified in any 
form. The lengths can be omitted depending on the 
subroutine called. The parameters needed to execute the 
subroutine are found at these addresses. 


HOW IT WORKS: the subroutine called is assembled in the main program 
and its relative addresses are changed to absolute 
addresses. In other words, the subroutine's actual 
initial address is added to the addresses relative to the 
conventional initial address 0, 
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The macro-instruction *N..N is translated into a JRT 
instruction at the initial address of the assembled subroutine 
and an address-form DC instruction is generated for each 
operand, specifying the address of the series of parameters 
required by the subroutine. 


For details on the usage rules, which are peculiar to each 


program, reference should be made to the relevant subroutine 
manuals. 


EXAMPLE: an example concerning the macro-instruction +*N,.N and which 
includes the use of the macro-instruction *N..N follows on pag.194. 
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**N.N 


Validate Peripheral Operation 


DESCRIPTION: this macro-instruction (applicable for EDOS and ETOS only) 
initiates the Validation phase of the subroutine previously 
called by the macro-instruction *N, .N. 


The use of a subroutine to control peripheral units by means 
of the two macro-instructions *N..N and **N..N allows 
overlapping between peripheral unit operations and internal 
processing. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 


OPERATION CODE: **N..N (N..N is the name of a subroutine present 
in the library without the initial letter Y: without 
the letter Y, the subroutine must have a maximum 
length of four characters). 


OPERANDS: they consist of addresses (and lengths) and are separated 
by commas. The addresses can be specified in any form. 
The lengths can be omitted depending on the subroutine 
called. The parameters needed to execute the subroutine 
are found at these addresses. 


HOW IT WORKS: before using the macro-instruction **N. .N,the subroutine 


YN..N must have been called in store by the macro-instruction 
¥N..N. 
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The macro-instruction **N. .N is translated into a JRT 
instruction to the initial address + 4 of the assembled 
subroutine, while a DC instruction in address-form is 
generated for each operand, specifying the address of the 
series of parameters required by the subroutine. 


EXAMPLE: this sequence of instructions allows overlapping of card reading 
and of internal processing of the card read previously. 


cenenne > ncerne scence censor EL] 
Sa ie oe LTT 
el ee ontnation OreRANOS - A 
al tea el i 4 : “ ff 
p a Aelol Lani lel lela fea Flrl leviaulel 
ao : 

fo| 4/o| 

aslo 

o|lo| a8 Iriel (RIE ADI Iie 

oug i eel restr 

Oogm ea leial felveluiol Tal {hi elegiciol 

[oj 9/0) UNIT) IF] E)L 1O 

RBEEEEECE 

noo rE ip] hw] IFlefelo [Bl 

nao I 

a 3]o/E Gel ES 

afafol [| ae | 

slo CITE LO 


The *CRZ2 macro-instruction on Hne 020 effects an off-loop call 
of the card read subroutine YCRZ2, thus assembling the subroutine 
itself, for execution of the Command phase only. 


The **CRZ2 macro-instruction on line 060 executes the subroutine's 
Validation phase. 


The *CRZ2 macro-instruction on line 090 effects an in-loop reading 


of cards and returns to the **CRZ2 macro-instruction on line 60, 
to validate the operation. 
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In order to insure a correct overlapping of card reading and of processing 
of the previous card, two storage areas, "A't and "B", have been provided. 
"A" receives the card just read while "B" receives the contents of the 

card read previously. 


Data for internal processing are taken from Store area "B"'. 
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INPUT/OUTPUT MACRO-INSTRUCTIONS (EIOS) 


‘The EIOS subroutines are called by the appropriate macro-instructions 
which are divided into four groups according to the type of peripheral 
unit used by the file: 

a. macro-instructions for card files 

b. macro-instructions for print files 

ce. macro-instructions for magnetic tape files 

d. macro-instructions for magnetic disc files 


NOTES: 1) the use of these macro-instructions assumes that the file 
has been defined by 2 FILE declarative instruction. 


2) These macro-instructions may not be used within a 
subroutine. 
Card Files 


The following maero-instructions ‘(applicable for EDOS and ETOS only) 
relative to the processing of card files are described on pages 197 to 202: 


OPEN Open File 
GET Read Card 
RLS Close Operation on Card Reader 


CLOSE Close File 
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OPEN 


Open File 


DESCRIPTION: this macro-instruction opens a card file, 


MACRO-INSTRUCTION FORMAT: 


NAME: any name } 
OPERATION CODE: OPEN 
OPERAND: symbolic name of file 


HOW IT WORKS: this macro-instruction checks the file and reads the first 
card of the file itself into the Card Read Area. 


EXAMPLE: open file ENTER, 


cenenar@ euecraic ; vecerncanen 

ee en TRE] - 

APS PROGRAMMING FORM rs 
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GET 


Read Card 


DESCRIPTION: this macro-instruction writes the card read into the area 
indicated by the program, 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: GET 
OPERAND: symbolic name of file 


HOW IT WORKS: the macro-instruction executes the following functions: 


- validates previous read operation in Card Read Area 


- moves the contents of the card previously read in the Card 
Read Area to the area specified by the BA operand in the 
FILE instruction 


~reads the subsequent card into the Card Read Area 


-re-enters the main program or starts the end-of-file 
routine. 
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SIGNAL MEANING OF SIGNAL ASSEMBLER BEHAVIOUR 


Length of block area is less | The instruction is translated 
than 80 characters (BK < 80) 


Léngth of block area (para- 
“meter. BK) exceeds maximum 
provided for by BIOS (equal 
to 27,000 positions) 


For files with numbered 
blocks and fixed-length 
records, the length of the 
block area has not been 
defined as the miltiple of 
the length of the work area 
+5 [px 4 n(R0+5)] 


For files with umnumberéd 
blocks and fixed-length 
records, the length of the 
block area has not been 
defined asthe multiple of 
the length of the work area 
(BK ¢ neRC) 
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Assembler Messages 


Under certain conditions, the assembly program issues the 
following meseages: - 


2401 *UNIT X: PERSISTENT Persistent error on unit with 
ERROR select number X. 
Program execution halts at 
addrese 0246; GO/NO GO 
condition: NO. 


2402 *UNIT X: OUT OF Unit out of order. 

ORDER If there is an out-of-order 

condition after a rewind 
command, the program etops 
on a wait HLT at address OtDa. 
The operator can restart the 
unit and press START. 
If the condition occurs after 
& read or write.instruction, 
the program halts at address 
0246 with GO/NO GO condition: 
NO, 


If it takes place in a final 
rewind operation, tle program 
terminates ‘in the usual way. 


2450 TRANSLATION TYPE Colum 5 or column 6 of’ the 
WRONG order card regarding a 
program translation contains 
an invalid character. 
Program execution stope at 
addresa 0245, GO/NO GO 
condition: NO. 


200 , Rev.Feb.1969 
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EXAMPLE: checkpoint executed on the file OUT preceded by an RLS executed 
on the file CARD. 


pectin, 2 SUT 
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CLOSE 

Close File 

DESCRIPTION: this macro-instruction closes the file (this operation is, 
not obligatory). 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: CLOSE 
OPERAND: symbolic name of file 


HOW IT WORKS: the assembler translates this macro-instruction into an 
instruction that writes a specific character in a given 
position of the file table. 


EXAMPLE: close the file INPUT. 
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BLT address 


MEANING OF HLT 


— Unit-out of setvice 
- read error 
- write error - 


This halt occurs during 
file opening or during 
execution of @ check~ 
point. 


This HLT occurs during 
file opening. 

It can have one of the 
following meanings: 


= the first tape label 
is not INT (or VOL1) 


= the second tape label 
is not the HDR1 


_7 after the HIRI, the. 


T™ ia not present. 


One of the comparisons 
made between the 
information on the HIR1 


‘label and that in the 


files table has given. 
a@ negative result. 
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ACTION TAKEN BY 
OPERATOR ~ 


~ If during file opening, 
press START to restart 
file opening. 


- If during checkpoint 
execution, press START 
to attempt reading 
or writing again. 


Mount the correct tape 
and press START. 


Mount the correct tape 
and press START. 

Or, to continue, turn 
on SWITCH 2 and press: 
START. 

In this case, the 
program stops on a wait 
HLT. At this point, turn 
SWITCH 2 off and press 
START again. 


An OPEN macro instruction 
has been commanded on a 
file already “open”, 


A NEXT macro instruction 
hae been commanded on a 
file that has not been 
"eloged," 


A CLOSE macro instruction 
hae been commanded on a 
file already closed, 


A CHKP macro instruction 
has been commanded on a 
file that ie not opened 
in output. 


Error in the final check 
of the blocks processed 
| in a standard input file. 


There ie a halt for 
reel change. 
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ACTION TAKEN BY 
OPERATOR 


Prese START to resume 
program execution from tha 
inatruction immediately” 
following the macro 
instruction concerned 
(which has no effect). 


To continue processing 
press SWITCH 2 and press 
START, At thie point the 
program egain stops on a 
wait HL®. Therefore tur 
off SWITCH 2 and press 
START again. 


Mount new tape and press 
START. 


Rev. Feb. 1969 
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Assembled Program 
Insert. (.APT) 


Binary Numbers 


Block Area 


Block Number 
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PART VI - APPENDICES 


This order program follows the .APS order and 
permits an assembled program to be inserted in 
the ST. Also, whenever possible, it standardizes 
the length.of program blocks. to 4096 characters. 


A numbering system using a base of two digits or 
"bits (0 and 1) as compared to the decimal 
system which uses a base of ten digite (0 to 9). 


4n item of information normally treated as an 
entity: ty hardware (physical record). 

On magnetic tapes, a series of characters that 
are read.or recorded during a single data - 
transfer operation. 

Each block is followed by an inter-block (or 
inter-recora) gap set to binary zero. 


Core Store area used for temporary storage of a 
Block before and after processing. 


See "Block Sequence Number" 


205 


Bleak Sequence 
Nuaber 


Oard Read Ares 


Connector 


Decimal Form - 


Endnof-File 
(goF1) 


Endeof=Volume 
(wovt) 


"| Bros 


File Code 
File Creation Date 


File Header Label 


File Identification 
Code 
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DEFINITION 


Decimal number (five digits in length) apecifye 
ing the sequential order of & data block withi 
& tape, Recorded in the first five characters 0: 
4 numbered block, If not prasent, the block is. 
called winumbered, 


Field in Syatem Reserved Area inte which oard 
cantenta are read. 


The GB 130 has four outlets (connectors) to 
which the peripheral units are physically tied. 
The connectors arg ewitched electronically 
between I/O channela, under Program control. 


Representation of the digita 0 to 9, 
See "File Trailer Label", 


See “Tape Trailer Label", 


ETOS ie a comprehensive set of. programs provide 
ing 4 software environment in which 0H 130 tape 
ariented eyetens can operate with maximum ef~ 
ficienoy and raliability, and with miniqua 
operator intervention, 


See "File Identification Cede", 


Date File was generated, recorded in File 
Header Label. 


An 8O-character blook of data identifying the 
beginning of a Standard File. Follows the Tape 
Reader Label. 


Alphanumeric File identifier used within a 
program. (6 characters long). 


206 Rev. Feb. 1969 


oo 


Qo 


APS REFERENCE MANUAL 


File Name Alphanumeric File identifier recorded in the 
12-character field of the File Header Label. 


File Purge Date 


Date indicating the day after which the File can 
be deleted or updated. Recorded’ in File Header 
Label. 


File Retention 
Period 


Length of time during which the File must not be 
modified (expressed in number of days). 


File Serial Number Number of the first reel on which a specific file 


is written. 


File Table 


Table generated by the APS Assembler and 
containing the characteristics of the file(s} 
required by a program. It is recorded just 
before associated program. 


File Trailer Label 
(EOF! ) 


An 80-character block of data identifying the 
end of a Standard Data Pile and the end of a 
tape. It contains the quantity of blocks in 

the File. 


File, Standard File containing standard blocks, ‘standard 
Header (VOL1 or INT1, and HDR1) and Trailer 


Labels (EOV1 or EOF!) and Tape Marks (TM's). 


Go/NO GO Condition 
Hexadecimal 


See "ID Sequence Validity Switch". 


. Conventional notation for designating the 16 
|. possible bit configurations of a quartet. 

‘Hexadecimal values are: 0,15243141516:7:9;9) 
A,B,C,D,E and F, 


. This notation can be’ used in card punching to 
introduce in Core Store any quartet configura- 
tion: one hexa, character per colum, two hexa. 
characters per octet. This is commonly refer— 

red to as "punching in hexadecimal". 
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+ Alternatively, a graphic (rather than a hexade- 
cimal) character having-a right quartet confi- 
guration in Core Store equal to the desired con- 
figuration can be used. These cards are said to 
be punched in “pure hexadecimal." 


Abbreviation for hexadecimal. 


Hexa. 


Thia code is used to identify a sequence of Order 
ards being used to perform a series of inter 
Pelated operations. 


ID Sequence 
Code 


Octet in System Reserved Area which is tested for 
the correct or incorrect execution of a program. 


ID Sequence 
Validity 
Switch 


Invalid Refers to an item of information which is not 
accepted as a valid representation by the machine 
design or by & specific routine or program. This 
term ig used in the Assembler messages. 

Index Special purpose two-octet fields in Core Store 

Register (or normelly used for address modification. Bight 

Registera) registers, numbered from 0 to 7, are available. 

Initialise Thies order program performs the initial operation: 

(nT) to start the Systen. 

1/0 Channele Input/Output Channels. The electronic data paths 


-used for tying peripheral unite to the CPU, 
allowing independent and simultaneous transfer 
of information. The GE 130 has three channels. 
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TERM DEFINITION 


Languages, APS 115 


Library Tape (LP) 


Loop 


Master Tape (MT) 


Monitor 


Order Cards 


The 115 software includes three APS versions: 
Basic APS, which is a one-to-one assembly 
program; Extended APS, which is an: expansion of 
Basic APS as it provides some macro instructions; 
APS II which is designed to be run under the 
supervision of the Tape Operating System (TOS) 
or Disc Operating System (DOS). 


These cards are used to update the File Tables 
associated with the Data Files required by the 
User Programs. 


This tape contains all the User (and Utility) 
Programs in working order. However, since it does 
not contain the ETS programs it cannot be used 
for executing User Programs. 


See "VFU (Vertical Format Unit)" 


This tape contains all User and ETOS programs 
needed for operations during a specific working 
period (shift, day, week). The programs 
contained in this tape have been debugged and 
are arranged in proper sequence for carrying out 
the planed schedule of operations. 


Last segment of each program on NT and used to 
load and start the next program to be executed. 


The basic unit of information in the GE 730 
System, composed of eight binary digits (bits). 


‘Cards selected by the user for calling specific 


Order Programs. 
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Order Programs 


Packed Mode 
(also "Form") 


Parity Bit 


Program Card 
Program Code 


Program 
Identification 
Code 


Program Load 
(;PRL) 


Program Tape 
Quartet 
Record 
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DEFINITION 


Programs called by Order. Cards for carrying out 
the ETOS functions, such as: Initialization, 
Translation, Debugging, Program Tape Generation 
and Maintenance, 


Generally denotes the packingof two decimal 
digits in a single octet. 


A check bit that indicates whether the total 
number of "i" bits in a character or octet 
(ineluding the parity bit) is add or even. If 
the total number of "1" bits is always even, 
the system uses parity; if odd, it uses 
disparity’. 


A. punched ecard contajning program instructions. 
See "Program Identification Code”. 


Alphenumeric program identifier (four characters 
in length) epécified in a Program card. 


This order program searches for, loads into Core 
Store, and starts a user's program located in the 
ST or MT. 


See "Tape, Program". 
Half an octet. 


Group of characters normally treated as an entity 
‘by the’ program (Logical Record). One or more 
Records in a Block, 


See "Tape". 
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A description of the following macro-instructions relative to the processing 
of tape files is given on pages 212 to 228. 


OPEN 
GET 


Open File 

Read Record 
Write Record 
Change Volume 
Write Checkpoint 
Pass to New Block 


Close Volume or File 
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OPEN 


Open File 


DESCRIPTION: this macro-instruction opens a file, that is it executes all 
those positioning and checking operations usually referred 
to as file opening. (See also utilization of LBC cards, as 
described in the Appendixes of the Operating System Manuals). 
The OPEN macro-instruction must always precede all the 
operations relative to a file, 


For files with non-standard labels, the macro-instruction 
OPEN calls the routine provided for by the user. Normal 
re-entry is at the instruction following the OPEN. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 

OPERATION CODE: OPEN 

OPERANDS: - OP. 1 symbolic name of file 
-OP, 21 ord 


indicates the type of file opening. It can have one of 
the following values: 


I open file for reading (input file) 
© open file for recording (output file) 
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Tape Serial Number 
(Volume or Reel) 


Tape, Standard 
Tape Trailer Label 
(Volume or Reel) 
(for Data Files) 


Tape Unit 
Controller Name 


Tape Unit Name 


Tape Unit Select 
Number 


Unpacked Mode 
(also "Form") 


VFU (Vertical 
Format Unit) 


Volume 


Work Area 


Work Tape (WT) 
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DESCRIPTION 


Alphanumeric tape identifier recorded in Tape 
Header Label (VOL1 or INT1). Six characters long. 


See "File, Standard" 
An 80-character block of data indicating the end 
of a standard tape. Designated by name,’ "EOV1". 


It contains the quantity of biccks in the volume. 


Controller identifier contained in Tape Unit Name. 
Fixed value, depending on peripheral configuration: 


Used by PER or PERI Instructions to address a 
tape unit. Fixed one-octet value, depending on 
peripheral configuration. 


Number assigned by the operator to a tape unit. 


Denotes the use of the right quartet only of an 
octet to store a decimal digit. 
It can also apply to binary numbers. 


The Vertical Format Unit, also called the VIU 
loop, is located under a cover at the right of 
the printer. The loop is an eight-track tape of 
metallized Mylar, with sprocket holes running 
the length of the tape, between tracks 3 and 4, 
for moving the tape. 


See "Tape" 


Core Store area used for temporary storage of 
one Record before and after processing. 


Tape used for intermediate storage of data files 
or programs. 
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B. PREREQUISITE AND. RELATED READING 


codes Title Catalog Number 


GOBOL Manual 0 be acsigned 


ETOS Operator's Manual Po be assigned 


ETOS Progranmer's Manual To be assigned 
FORTRAN Manual “to be aseigned 
Reference Manual CPB~1896 

SPG Manual To be assigned 
Subroutine, Vole 1 and 2 fo be assigned 


Codes: R Prerequisite Reading 
R Related Reading 
A. Analysts, Programmers 
O Operators 
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The 130 assembler is called by the .APS order card, which has the 


following layout: 


columns 


colum 


column 


columns 


colume 


columns 
colums 


columns 


1 
5 


6 


TT 


4 


14 
49 


6 
8 


identification code: .APS 


souree program language 


-}, if the GE 115 source program is card— 
punched in APS II or Basic APS 

- 1, if the GE 115 source program. is card— 
punched in Extended APS 

- 2, if the GE 115-APS II source program is 
written on tape (WT1) 


type of source program: 


-}, if it ie a program 
- +, if it is a spbroutine 


program name 
\ 


program description, which will be printed 
as the heading of the translated progran's 
printout 


not used 
serial code, if required 
blank. 


The operating standards used for tranelation are those described on 


page 191 of this manual, 


During a program's execution phase, the supervisor oan. control both 
130 and 115 programs (written on the 130 System's Master Tape) 
because of the possibility of ueing BIOS 130 or BIOS 115. 
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115 programs are ineertéed on the 130 Waster Tape by: 


t) creating a temporary 130Library Tape from a 115 Library 
Tape 


It) setting up 2 new 130 Library Tape (with 115 and 130 
programs) using the temporary 130 Library Tape ard. the 
already existing 130 Library Tape (with 130 programs only) 


TII) setting up a 130 Master Tape from the new Library Tape. 


1 TEMPORAR' 
13047 y 
‘TEMPORAR! 
1307 
nt Z 
il 


Programs from the 115 Library Tape are inserted on the 130 Master 
Tape by using appropriate order programs. 
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NEXT 


Change Volume 


DESCRIPTION: this macro-instruction allows processing to be continued 
on the alternate tape unit that is specified in the FILE 
instruction. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: NEXT 
OPERAND: symbolic name of file 


HOW IT WORKS: the macro-instruction is used only for standard files 
and executes the following operations: 
- For input files: 
» rewinds reel 
. updates parameters for change of reel 
- reads and checks the labels of the new reel 


- Bositions the new reel in front of the first 
data block. 
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- For output files: 
- rewinds reel 
. updates parameters for change of reel 
« reads and checks the labels of the new reel 
+ writes the new HDR1 label 


EXAMPLE: change volume and close file ARCH, under EDOS. 


GENERAL @D ELectnic ‘ IDENTIFICATION. ‘Fine initae LL 
‘ca wcant FRaCR ae PROGRRMER | Bare |<< 
eee ree TTT 
Aton Hl 
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Mz i 
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This example is also valid in DOS or TOS but for the FILES formats. 


NOTE: the execution of the NEXT macro-instruction assumes that the file 
has already been closed hy the CLOSE macro-insiruction, 
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CHKP 
Write Checkpoint 


DESCRIPTION: this macro-instruction (applicable only for DOS, TOS and 
ETOS) interrupts the normal sequence of blocks in an output 
file (on tape) in order to write a checkpoint on that file. The 
checkpoint can be defined as the amount of information 
(store contents, file positioning, etc). required to resume 
the program from the point where the writing took place. 


DOS I and EDOS accept this macro-instruction as a DCKP 

and therefore write a checkpoint on a disc file. In this case 
OP.1 is disregarded, and OP.2, OP.3 and OP. 4 are 
considered respectively as OP.1, OP. 2 and OP. 3 of the DCKP. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: CHKP 


OPERANDS: - OP. 1 symbolic name of the file on which the writing 
takes place, The file should have been opened at 
output, 
- OP. 2 PR - this operand is optional. If present, a 
checkpoint counter is printed which is incremented 
by 1 each time the CHKP macro-instruction is executed. 
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The printed message has the following form: 


- In DOS/TOS: 
EXECUTED CHKP N. XXXX ON VOLUME YYYYYY 


» In ETOS: 
EXECUTED CHKP N. XXXX, VOLUME YYYYYY, UNIT Z, VW 


in which XXXX is the number of checkpoints printed; 
YXYYYY indicates the serial number of the volume on 
which the file is written; Z is the select number of the 
unit containing that volume; V specifies the type of read 
check (O = even parity, P = odd parity); W indicates the 
recording density (K = 1600, L = 800, M = 556, N = 200). 


- OP, 3 HT - this operand is optional. If present, processing 
stops on a HLT after executing the CHKP. 
-OP.4 (address) 


This operand, by means of a symbolic name or a decimal 
value, represents the start address of a routine prepared 
by the user and started by the re-start order program 

(. RST) before re-starting the main program. This operand 
is optional, 


HOW IT WORKS: the macro-instruction writes the following information on the 
indicated file: 


- tape mark 


- label containing the checkpoint sequence number and the 
restart address 


- two blocks containing the BIOS locations to be restored 
- a block containing Core Store contents 


- tape mark, 
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EXAMPLE: write checkpoint on the file OUT, and print message. 
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the execution of the macro-instruction CHKP assumes that the file 

is standard and that it is contained on a 9-track tape. An RLS 
macro-instruction for card reading and/or and RLS macro-instruction 
for printout, must precede a CHKP macro-instruction, if the tape is 
7-track or the program uses card and/or print files, this is in order 
to close and write the possibly incomplete data block. 
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RLS 
Pass to New Block 
DESCRIPTION: this macro-instruction interrupts the processing of a block 
to go on to process the next block, It is not significant if the 
file consists of single-record blocks (parameter UN on the 
File instruction). 
MACRO-INSTRUCTION FORMAT: 
NAME: any name 
OPERATION CODE: RLS 
OPERAND: symbolic name of file 
HOW IT WORKS: for input files, this macro-instruction causes all the 
processed files present in the BA to be discarded, with 
the result that the next GET macro-instruction reads a 
new block, 
For output files, the macro-instruction writes the content 


of the BA even if incomplete. The next PUT macro-instruction 
begins the formation of a new block, 
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EXAMPLE: after a comparison of the key of the last record read in the ALPHA 
file, read the first record of the next block. 


EVAlDL ann 
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CLOSE 


Close Volume or File 


DESCRIPTION: the processing of an input or an output file ends when the file 
is closed by this macro-instruction. File closing is not 
mandatory except when the file has to be reprocessed and, 
therefore, reopened. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 

OPERATION CODE: CLOSE 

OPERANDS: -OP.1 symbolic name of file 
-OP.2 ULorNn 


UL the reel is rewound and the unit is set to 
standby, after execution of the CLOSE. It is 
not considered for non-standard files. 


N_ the positioning of the tape after execution of the 
CLOSE macro-instruction, remains unaffected. 


The operand OP, 2 may be absent; in this case the reel 
is only rewond, after execution of the CLOSE. 
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HOW IT WORKS: this macro-instruction provides for all of the following 
operations (on standard files), The operations to be 
actually carried out may be specified by the LBC cards. 


For input files: 

- Checks for the presence of the file (it must have been opened 
previously) 

- Checks correct matching of number of blocks on standard files. 


~ Rewind reel according to the type of operands indicated in the 
instruction. 


~ Effects re-entry to the main program. 
For output files: 
- Writes, if necessary, an incomplete block present in BA. 
- Writes tape mark. 
. +Writes trailer label (EOV1 or EOF1). 


~ In DOS, TOS or DOS I, writes tape mark if end-of-volume, 
or two tape marks, if end-of-file, 
In EDOS or ETOS, writes two tape marks. 


- Rewinds reel according to the type of operands indicated 
in the instruction. 


- Effects re-entry to the main program. 
if a CLOSE macro-instruction is issued before the trailer 
Jabel is read on an input file, the subroutine does not 


perform any check and positions the tape as specified by 
OP. 2. 
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EXAMPLE: close the file INPUT and set the unit to standby. 


Jpneincaries Pace muster ] 
PROGRAM WARE ‘PaocRmmneR | oare |= On 
Tin. 


abe 


NOTE: 


for an output file, it is necessary, before issuing the CLOSE macro- 
instruction, to indicate whether the volume or the file is to be closed, 
For volume close, the characters EOV are transferred to the first 
three positions of WA (or BA if the file consists of single-record 
blocks). For file close, the characters EOF are transferred. 


However, in case of end-of-file, if the characters EOF are not 


inserted in the first three locations of WA (or of BA), they will 
be automatically recorded by the CLOSE macro-instruction. 
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Disc Files 
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The following macro-instructions can be used to process disc files. They 


will be described in pages 230 to 272, 


OPEN Open File 

GET Read Record 

FIND Find Record 

PUT Write Record 

PUTX Update Record 

DEL Delete Record 

SEEK Position Heads 
DCKP Write Checkpoint 
COPY Copy Index Cylinder (DOS II/EDOS only) 
NEXT Change Volume 
CLOSE Close Volume or File 
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OPEN 


Open File 


DESCRIPTION: this macro-instruction is used to open a file, that is to 
execute all those positioning and checking operations that 
are usually referred to as file opening. (See also Appendixes 
of Operating System manuals, for format and use of LBC 
cards). The OPEN macro-instruction is always required 
before any series of operations on a file, 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: OPEN 
OPERANDS: - OP.1 symbolic name of file 
-OP.2 I, O, U, or 
Indicates the type of file opening as follows: 


I open input file 


O open output file. Only applicable for 
sequential files, meaning "generate new file" 


U open file for updating 


C open partially recorded output file. The new 
records are appended to the existing records 
in the file. Applicable for sequential processing 
of the first volume of a sequential file. 


230 


APS REFERENCE MANUAL 


HOW If WORKS: the macro-instruction OPEN is translated into a series of 
instructions which calls the routine for opening the file. 
The operations executed by the OPEN macro-instruction 
depend upon the type of file processing, as shown below: 


A. 


Sequential processing (AM = S$ in FILE instruction) 

The OPEN operates as follows: 

- Checks the volume label in first volume of file, 
then prints it if print option is present in LBC card. 


- If volume label is correct, sets up file table, for 
reading or writing of first page. 


- Checks that overflow area is present if required by type 
or processing mode of file. 


~ Completes file table to make it available for other EIOS 
macro-instructions. 


- In the case of output files, records the file label, or 
updates it as required (for example, with new purge date). 


The OPEN macro-instruction, when executed on file being 
declared as absent by an LBC card, has no effect whatsoever. 
(¥ in col. 49 of LBC card, in DOS/TOS; CO = co in DOS I/EDOS). 
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Random or random-sequential processing (AM = R or M 
in FILE instruction) 


OPEN operates as follows: 


- Ina multi-volume file, it checks that all volumes of 
the file are ready for on-line processing. The volumes 
of the file must be mounted on dise units with ascending 
numbers, i.e. volume 1 on unit X, volume 2 on unit 
X+1, volume 3 on unit X + 2, etc. 


The OPEN macro-instruction checks first the file label 
in the first volume, then the file labels in the subsequent 
volumes, until the label with end-of-file signal is found 
(F in position 35). 


The number of on-line volumes must not be greater 
than specified by the FILE instruction. 


- In the case of random processing using the file Index, 
the OPEN macro-instruction checks that the index is 
present on every volume of the file and only transfers 
to Core Store the file Index of the last volume. 


- Completes the file table and also adds to it a 15-character 
field (in DOS U/EDOS, 10-character field in DOS/TOS) 
for each volume of a multivolume file. This field contains 
the start and final addresses of the file in each volume. 


- If required, checks that the overflow area is present. 
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Regardless of the processing mode, the OPEN macro- 
instruction can perform all of the following check 
operations, or a part of them as specified by the 

LEC cards: 


a) 


by 


ce) 


Checks that the first volume of the file is mounted 

on the unit indicated; in random or random-sequential 
processing mode, all volumes in the file are considered 
as being mounted on dise units with consecutive 
ascending numbers. 


If the associated file table contains the option that 
considers the file as absent, the input file opening 
procedure is disabled. 

Checks that the file was not opened before. 

Note that a file can be re-opened after it has 

been closed. 


Reads the file label and checks the following 
information for validity: 

« file serial number 

« sequence number of volume in file 

« file creation and purge dates. 


The first two items must be the same as the 
corresponding values in the file table. The OPEN 
for the first volume places the value 0001 in the 
field "volume sequence number" of the file table. 


The checking of the date may be of two types: 
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In sequential output files, the purge date read from 
the label of the volume to be opened, must be less 
than or equal to the creation date of the file to be 
generated. 


For any other type of file, the creation date in the 
label must be the same as in the file table. 


d) If the print option is specified, the following file 
labels are printed out: 


a The label of the first volume of the file, in 
random processing of single-or multi-volume 
files. 


e The label of the first volume of the file, in 
sequential processing. The labels of each 
subsequent volume will be printed out when 
being "opened" by the NEXT macro-instruction. 


e) Furthermore, of the check option is specified in the 
LBC card and any discrepancies are detected, a part 
of the file table is also printed out, before the HLT 
that signals the error. This HLT allows operator's 
action; according to the instructions given to him, 
he may either change the volume or disregard the 
error, pressing SWITCH2 before resuming 
processing. 


EXAMPLE: open file ARCH for updating. 
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DESCRIPTION: 
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In addition to reading a page into the Block Area (BA), this 
macro-instruction also performs the logical processing of 

the file by supplying to the user, according to file organization 
and processing mode, either the required record in the 

Work Area (WA), or its address in an index register (EDOS 
only), If the file is of the UN type (single-record pages), 

the GET macro-instruction only performs physical processing 
that is reads one page and writes it in the Block Area. The 
format and operation of this macro-instruction are variable 
with file organization (FILE, OP.11! in DOS I/EDOS; OP.1, 
card 3, in DOS/TOS), and processing mode (FILE, OP. 21: in 
DOS H/EDOS; OP.1, card 5, in DOS/TOS), as described in 
the following pages. 
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A. Sequential or random-sequential processing 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: GET 
OPERAND: symbolic name of file 


HOW IT WORKS: this macro-instruction supplies the records sequentially, by 
writing one record at a time in WA (or in BA if UN file),or 
its address in an index register (EDOS only) if so specified 
by the FILE instruction. Each record supplied to the user 
is physically located on disc immediately after the record 
read by the preceding GET. If the parameter DA is specified 
in the FILE, this macro-instruction also causes the complete 
record address on disc to be supplied in the field indicated 
by DA. If operating on a sequential file with overflow area, 
any record chaining in overflow area is also considered. In 
this case however, index registers cannot be used, In random- 
sequential processing, the macro-instruction GET of the 
first record must always be preceded by a macro-instruction 
FIND (see page 245). 

If invalid records are read (see "Data File Organization" manual, 
for definition of these records), they are rejected, but any 
record chaining in overflow area is considered. If end-of-file 

or end-of-volume occurs, the user routine, as specified by 

the parameter EV of the FILE, is executed. Before starting 

this routine, register 7 (in EDOS) or Store locations 254-255 

(in DOS/TOS/DOS 11) contain the re-entry address (instruction 
following the GET). 
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The user can tell an end-of-file from an end-of-volume 
condition as the GET transfers to the first three positions 

of the WA, (or the BA if the file is unblocked), the characters 
EOF and EOV in the two cases respectively. 

In random-sequential processing of multi-volume files, 
switching over from one volume to the next volume in 

logical sequence, is done automatically. When the file, in the 
volumes following the first is broken (only DOS or TOS), it is 
necessary that, the GET of the first record of each volume, 
be preceded by a FIND. If not, when the first part of the broken 
file is processed, the program will jump to the user's routine 
which treats the EV condition. 


The macro-instruction GET when executed on a file being 
declared as absent by an LBC card (¥ in col. 49 in DOS/TOS; 
CO =co in DOS I/EDOS) instead of getting a record jumps 
to the user's routine that treats the EV condition which is 
declared in the FILE statement as EV. 


EXAMPLE: read a record from the file ALPHA (sequential processing). 
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B. Random processing of sequential files 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 

OPERATION CODE: GET 

OPERANDS: - OP.1 symbolic name of file 
-OP.2 R, T, Ior blank 


Indicates the record addressing method, 
using one of the following values: 


R - Direct addressing or record addressing. 
When a record address is given in the 
Disc Address (DA), the GET supplied 
that record in the Work Area (WA). 
This parameter cannot be used for 
records in overflow area. 


T - (DOS or TOS) track addressing. The track 
address is given in the Disc Address (DA) 
and the record key is supplied in the KA 
field. DOS I or EDOS addressing by 
pair of tracks. The address of an even- 
numbered track is given in the Disc 
Address (DA), and a record key is 
supplied in the KA field. 
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The GET reads that record into the Work 
Area (WA) and its record address into the 
Dise Address (DA). This parameter is also 
applicable for sequential files with overflow 
area. 


I- Addressing method using File Index. When a 
record key is given in KA, the GET macro- 
instruction only reads its track address into 
the Dise Address (DA). Applicable only for 
sequential files with Index. 


blank - OP.2 absent indicates "Addressing method 
using File Index", and requires the record 
key to be given in KA, but unlike the previous 
case, the GET macro-instruction reads the 
actual record into the Work Area. Its record 
address is also supplied in the Disc Address. 


HOW IT WORKS: depending on OP. 2 specification, this macro-instruction 
supplies a record in the Work Area (or in Black Area if 
the file is unblocked}, its address in the Disc Address, or 
both, 

Upon completion of the GET macro-instruction, the results 
of record search are given as follows, depending on OP. 2 
specification: 


-If£1, the UF/OF and ZE/NZ contents are not significant. If 
the record is not found, the DA field will contain the track 
address of the record with the next higher key. 
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- In the other cases, the results will be shown in the UF/OF and ZE/NZ 
indicators, as follows: 


Or NZ 
1 Ui) ({hexa 20) record found 
1 1 {hexa 10) record not found, the immediate record 
with greater key value is supplied in WA (or BA). 
Ui) 1 (hexa 40) one of the following may occur: 


e@ The user-supplied address in DA is not 
included within file bounderies (as specified 
in HDR1 label). In this case if GET had OP. 2 
=R, it is valid only for DOS If , EDOS. 


e@ The record requested has not been found nor 
one with greater key value in the pair of tracks 
(or on the track DOS/TOS$) specified. This may 
only occur if OP. 2 is equal to "I" or absent. 


In random processing of sequential files, no end-of-file or end-of- 
volume signal is given. 
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EXAMPLES: 


L Read record from sequential file (ALPHA) with Index, after moving 
record key to KA field (with name K), 


IL Read record from sequential file (ALPHA) with Index, after moving 
the track address (or pair of tracks) to Dise Address (with name J) 
and record key to KA field (with name K). 
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C. Random processing of random files 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: GET 
OPERANDS: -OP.1 symbolic name of file 


-OP.2 R or blank 


Indicates the record addressing method, using 
one of the following values: 


R - Direct addressing (record addressing). 
Records are addressed directly, i.e. the 
user must supply the complete address of 
each record in the Disc Address (DA). 


blank - OP, 2 absent indicates addressing method as’ 
specified by the parameter RI of the FILE 
instruction, namely: 


PG = Page addressing. 
The page address must be given in DA 
and the record key in KA. 
The search is restricted within that 
page. 

SS = e MOS or TOS) Track addressing. The user 
must supply in DA the address of a track, 
and in KA the record Key. The search 
is restricted within that single track. 


e (DOS II or EDOS) Addressing by a pair of 
tracks. The user must supply in DA the 
address of an even-numbered track, and in 
KA the record key. The search is restricted 
within that pair of tracks. 
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MS = e (DOS or TOS) Track and cylinder addressing. 
The user must supply in DA the track address 
and in KA the Key Address. If the record is 
not found, the search continues on the 
following tracks of the same cylinder. 


e@ (DOS Tor EDOS) Addressing by pair of tracks 
and volume. The user must supply in DA the 
address of an even-numbered track and in KA 
the record key. 

If the record is not found in that pair of tracks. 
the search continues in the adjacent tracks 
and cylinders within the volume. 


HOW IT WORKS: The macro-instruction supplies the desired record in the 
Work Area or in BA of the file is unblocked and its dise 
address in the Disc Address. 


UF/OF and ZE/NZ show the results of the operation as follows: 


OF 
1 


NZ 


tt) 


(hexa 20) Operation successfully completed 


(hexa 10) Record not found, but there is 
sufficient room in the unit specified, to 
contain it. 


(hexa 40) Reeord not found nor is there 
sufficient room in the unit specified to 
contain it or (in DOS Il or EDOS) if the 
user-supplied address in DA is not 
contained within file boundaries. 
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In random processing of random files, the GET 
macro-instruction never supplies end-of-file or 
end-of-volume signals. 


In the case of multi-volume files, all volumes must 
be available on-line at the same time. Switching 
between volumes is done automatically. 


EXAMPLES: 

I, Read record from file ALPHA, after moving its complete address to 
the DA field (with name 1). 

TL Read record from file BETA, after moving its key to the KA field (with 


name K) and the address of a pair of tracks (or track address in DOS/TOS)to 
the DA field (with name I). The FILE instruction, which defines the 
file BETA, uses the parameter RI = 88. 
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FIND 


Find Record 


DESCRIPTION: macro-instruction used only in random-sequential processing 
to access a given record directly. It does not supply the record 
but only presets the parameters in the file table to allow the 
subsequent GET to actually read the record, When a record 
is found, the FIND instruction does not supply the complete 
record address in DA, but it will he supplied by the following 
GET of the file. 

As a prerequisite for the use of this macor-instruction, the 
specified file must have been opened for reading or updating 
(OPEN, OP. 2), Each GET or series of GET's in random - 
sequential processing must be preceded by a FIND. 


MACRO-INSTRUCTION FORMAT: 
NAME: any name 


OPERATION CODE: FIND 
OPERANDS: - OP.1 symbolic name of file 
-OP.2 R,T, I or blank 
R - Direct addressing (record addressing). The user 
must supply in the DA field the complete address 
of 2 record in the main disc area. 


This parameter can not be used on records in overflow 
zone, 
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T -e (DOS or TOS) Track Addressing, 
The user must supply the track address in DA and 
the Key in KA. The search is limited to a single 
track. 


e@ (DOS II or EDOS) Addressing by pair of tracks. 
The user must supply in DA the address of an 
even-numbered track in the main disc area, and 
in KA the record key. The search is limited on a 
pair of tracks. 


I - Addressing with file Index. Only applicable for 
files using the Index. 
When a record key is given in the KA field, the 
macro-instruction retrieves the address of the 
pair of tracks where the record is located and 
supplies it in the DA field. 


blank - When operand 2 is not specified, in the case of a 
file with Index, the macro-instruction supplies 
in the DA field the complete address of a record, 
whose key was previously given in the KA field. 
This combines the operations of two FIND's, with 
parameters I and T, in sequence. 


HOW IT WORKS: the UF/OF and ZE/NZ indicators show the results of the 
operation, as follows: 


or NZ 

1 0 (hexa 20) record found 

1 1 (hexa 10) record not found but exists a valid record 
of greater key value. 

0 1 (hexa 40) record not found and does not exist a valid 


record of greater key value. 


Before issuing a GET macro-instruction the user must test the 
result of the search by using a "jump on condition” instruction. 
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The function of the following GET varies according to the content of the 
indicators. On result 1 0 the macro-instruction GET supplies the 
record with the key value that was searched for. 


On result 1 1 the GET supplies the first valid record with greater 
key value. 


On result 0 1 the GET initiates the execution of the END-of-FILE 
routine which is identified as EV on the FILE Statement. 


When addressing by pair of tracks (or track addressing in DOS or 
TOS) with OP.2=T, any chaining in overflow area is considered. 


If the record is found in overflow area subsequent GET's will read 
the complete string of the chained records before supplying the records 
from the main area. 


EXAMPLE: search file DISC1 for a record whose key is given in the KA 
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field (with name K), using file Index, then, subject to result 
of search, read record. 
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Write Record 


DESCRIPTION: 


APS REFERENCE MANUAL 


this macro-instruction is used to write a record in a file, 
previously opened for recording (OP. 2 = 0 in OPEN) 

or updating (OP. 2 =U in OPEN). 

The user must supply the record in the WA field, if recording 
file, or in the RA field, if updating file. 

The macro-instruction is case of an output file, moves the 
record from the WA into the BA then writes a page on disc. 
When updating files it writes on disc the record residing in the 
RA, transferred by the user. 

If the file is unblocked and in output, the user must supply 
the record in BA area or in RA when the file is in updating. 
The macro-instruction PUT writes every time a page on disc. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: PUT 
OPERAND: symbolic name of file 


HOW IT WORKS: this macro-instruction has a fixed format, but its operation 


varies with the type of the file (FILE, OP. 11 in DOS w/ 
EDOS; OP. 1 card 3 in DOS/TOS) and with the processing 
mode (FILE, OP. 21 in DOS 1/EDOS; OP. 1 card 5 in DOS/ 
TOS), as follows: 
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RECORDING FILES 
Only applies to: 
A. Sequential processing of sequential files. 
UPDATING FILES 


Refers to insertion of new records, while the macro-instruction PUTX is 
used to replace old records, Each PUT or series of PUT's must be 
preceded by a GET, which finds the areas where the record(s) are to be 
written. It is important to note that the PUT must not be used after a GET 
with operand 2 = R (direct addressing). File updating applies to one of 
the following cases: 


B. Sequential or random-sequential processing of 
- sequential files. 


C. Random processing of sequential files. 


D. Random processing of random files. 


Sequential processing of sequential files. 
{files recording) 


The user must supply the record in the field specified by the parameter 

WA of the FILE, or in the field whose address is contained in an index 
register (only in EDOS); the PUT moves the record to BA and, after a 

page is completed, writes it on disc. If the file is of UN type (single-record 
pages), the user must supply the record in the BA area, then each time the 
PUT writes a page in the file. 
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If the operand DA is specified in the FILE, the PUT causes 
the complete address of the record to be written in the field 
indicated by DA. 

After the last page has been recorded in a volume of the file, 
an end-of-volume condition occurs, and the routine EV is 
entered for file closing. 

Any PUT (s) following the end-of-volume or end-of-file 
indications are rejected. 

The user can request volume or file closing by moving the 
characters EOV and EOF respectively to the first three 
positions of WA (or BA in the case of UN files). 


EXAMPLE: write a record in file ALPHA, previously defined for recording 
and sequential processing. 
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Sequential or random -sequential processing of sequential files (file updating). 


The user must supply the record in the field specified by the parameter RA 
of the FILE. The PUT writes it in the overflow area by using the chaining 
method. The record or series of records being inserted by one or more 
PUT's always precede (in logical sequence) the record read by the previous 
GET. 

The record types and the chaining fields are modified, as required, by the 
macro-instruction. Ifa series of PUT macro-instructions is specified after 
the GET, a series of records are obtained in the overflow area, properly 
chained to the record read. In this case the records are linked together in 
the same sequence of the PUT's, regardless of the values of the individual 
record keys. 

If for example, after reading a record with key 45, two PUT's are 
executed on records with keys K4 and K3, the logical sequence of the 
records in the file will be: K4, K3 and K5. 


The UF/OF and ZE/NZ indicators show the results of the PUT macro- 
instruction, as follows: 


OF NZ 


0 (hexa 20) updating successfully executed 


1 1 (hexa 10) no updating, because no GET was specified 
before 

o 1 (hexa 40) no updating, due to inadequate space in overflow 
area, 
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A prerequisite for the use of the PUT is that the file was previously 
defined for updating and that the parameter RI in the FILE was 
specified = CH. If the record format includes the key field, the 
FILE must also specify the parameter KS indicating the key length. 


EXAMPLE: 


GENERAL @D ELecraIC 


une | mane 


write a record in the overflow area of the file ALPHA, after a 
GET and a comparison between the key of the record read in 
the WA field (with name KEY 1) and the key of the record to be 
written located in the RA field (with name KEY 2). 
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C. Random processing of sequential files (file updating) 


The macro-instruction GET which must precede the PUT may have either 
the option T (track addressing or addressing by pair of tracks) or blank 
(addressing with Index) in operand 2. Note that a PUT may not follows 

a GET with option R. Record search by track or by pair of tracks 

(DOs II or EDOS) terminates on record with higher key. The GET will 
then generate a "record not found" condition. If a record with the same 
key is found, no record must be inserted but an existing record must be 
modified by using a PUTX instead of a PUT. 
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The user may specify a PUT when the GET has signalled "record not found" 
In this case the new record, supplied by the user in the field defined by the 
parameter RA, is written in the overflow area, and chained to the record 
with the next higher key, i.e, the record where searching has terminated . 
Chaining may also occur to a record located in overflow area, 


The UF/OF and ZE/NZ indicators show the results of the PUT macro- 
instructions, as follows: 


OF NZ 
1 0 (hexa 20) record inserted 
1 1 = (hexa 10) record not inserted, because no GET was specified 


before, or the GET has not signalled "record not found". 


0 1 = (hexa 40) record not inserted, due to inadequate space in 
overflow area. 


EXAMPLE: insert new record in sequential file ALPHA, after searching for 
chaining record using Index. The key (with name KEY 1) of the 
record to be inserted is supplied in the KA field (with name K). 
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D. Random processing of random. files (file updating) 


The macro-instruction GET preceding the PUT must have OP. 2 blank. 
Addressing may be by page, pair of tracks, or by pair of tracks and volume, 
depending on the RI parameter specification in the FILE, 

Note that a PUT may not follow a GET with option R and that the preceding 
GET is intended to find a field where to write a record, rather than to find 
the record itself. Therefore the PUT may only be issued if the GET signals 
that the specified record was not found but sufficient space is available in the 
volume to hold it (11 configuration in UF/OF and ZE/NZ). If neither the 
record, nor sufficient space for receiving it, was found, record insertion 

is left to the user. 


The UF/OF and ZE/NZ indicators show the results of the PUT, as follows: 


OF NZ 
1 0 (hexa 20) record inserted 
1 1 = (hexa 10) record not inserted because the last macro-instruction 


was not a GET, or was a GET that did not result in a UF/OF, 
ZE/NZ configuration of 11. 
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EXAMPLE: insert new record in random file ALPHA, after a random search 
for a receiving field on disc. Searching is done by a GET using 
the addressing method by pair of tracks. 


The user must supply the record key (with name KEY 1) in the 
KA field (with name K) and the track address (with name INDT) 
in the DA field (with name I). 
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Update Record 


DESCRIPTION: 
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this macro-instruction is used to update a file by modifying 

the existing records. Note that record types, keys, chaining 
fields and lengths may not be modified. 

The PUTX can be used for any type of file and in any processing 
mode and only requires that the fiel be opened for updating 

(OP. 2 =U in OPEN). 


MACRO-INSTRUCTION FORMAT: 


NAME: 


any name 


OPERATION CODE: PUTX 
OPERAND: symbolic name of file 


HOW IT WORKS: this macro-instruction substitutes the record located in WA 


(or in BA for unblocked files) for the record supplied in WA 
or in BA by the preceding GET. The user must obviously 
modify the record, as required, in between the read (GET) 
and write (PUTX) operations. 


Each PUTX causes a page to be written on disc in one of 
the following cases: 

= random processing 

-UN file (single-record pages) 


- record to be updated is in overflow area. 
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In the other cases, a page is written before reading another page, or when 
a CLOSE is executed. 


In random processing, the PUTX requires that the preceding GET have 
signalied "record found" (10 configuration in UF/OF, ZE/NZ). 


The UF/OF, ZE/NZ indicators show the results of the PUTX, as follows: 


OF NZ 
1 0 (hexa 20) record updated 
1 1 = (hexa 10) record not updated because the last macro-instruction 


was not a GET, or was a GET but has not found the record. 


In sequential processing of sequential files opened for updating, the PUTX 
may also be used after a PUT, to modify the record supplied in WA (or in 
BA for unblocked files) by the preceding GET. 


EXAMPLE: read and update a record of the file ALPHA, after comparing the 
key (KEY 1). 
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DEL 


Delete Record 


DESCRIPTION: this macro-instruction is used to delete a record read by the 
preceding GET, by modifying the record type field. May only 
be used in file updating (OP. 2 = U in OPEN). It is important 
to note that a sequential file may not be processed in random 
mode, if it contains records that were deleted, by DEL-macro 
instructions, during previous sequential or random~sequential 
processing runs, 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: DEL 
OPERAND: symbolic name of file 


HOW IT WORKS: this macro-instruction writes the hexadecimal value ''5" 
in the left quartet of the record type field, while the right 
quartet remains unaffected. 

Tis the record is made invalid, but any record chaining 
in overflow area is not affected, 
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EXAMPLE: delete a record in file ALPHA, after comparing the key (KEY 1). 
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SEEK 


Position Heads 


DESCRIPTION: this macro-instruction may be used, a number of instructions 
ahead of a GET, PUT or FIND, to position the read/write heads 
on the desired cylinder, thus allowing the program to continue 
immediately after the operation is started. 


NOTE: hy using a GET, PUT or FIND, not preceded by a 
SEEK, the CPU is interlocked through the entire 
head positioning phase. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 

OPERATION CODE: SEEK 

OPERANDS: ~OP.1 symbolic name of file 
-OP.2 Lor blank 


Indicates the cylinder where the read/write mechanism 
is to be positioned, as follows: 


I - Position read/write heads on Index cylinder. Only 
applies to files with Index. In the field defined by 
KA in FILE, the user must supply the key of any 
record located in the relevant volume. 
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plank -When operand 2 is absent, the user must supply in 
the field specified by DA in FILE, any track/volume 
address in the cylinder where positioning is required. 


HOW IT WORKS: this macro-instruction causes the read/write mechanism to 
be moved to the cylinder specified by operand 2. 
If the key supplied in KA does not allow volume identification, 
or the track address supplied in DA does not lie between the 
boundaries of the file, as assigned by the HDR1 label, the 
macro-instruction has no effect and does not provide any 
condition signal. 


EXAMPLE: execute a SEEK on file ALPHA, by moving read/write heads to 
Index cylinder, then a GET which searches the Index for a record 
address. 

The record key and the KA fields were previously assigned the 
names KEY and K respectively. 
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DCKP 
Write Checkpoint 


DESCRIPTION: this macro-instruction is used to write a checkpoint in an 
appropriate file on disc, which was previously assigned to 
the same volume that contains the program file. A check- 
point can be defined as the set of data (Core Store contents, 
file positioning information, etc.) that are required to 


restart the program from the point where the checkpoint was 
recorded. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: DCKP 
OPERANDS: - OP. 1 PR 


Optional operand specifying the printout of the following 
message, as the checkpoint is being recorded: 


EXECUTED DCKP N, XXXX ON VOLUME YYYYYY 


where XXXX is the checkpoint number and YYYYYY is 
the serial number of the volume where the checkpoint is 
recorded, 
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-OP. 2 HT 


Optional operand used to stop processing on a HLT 
instruction at address 00F8 at the end of the DCKP. 


- OP. 3 (address) 


Optional operand specifying the address, expressed by a 
symbolic name, of the start address of a user-developed 
routine to be called by the restart program (e RST in 
DOS/TOS or © DRST in DOS It or EDOS) before resuming 
the main program. 


HOW IT WORKS: the DCKP writes the checkpoint in a particular file, located 
in the same volume that contains the program file. The file 
name, defined by the user thru the order 6 FLW in DOS/TOS 
or @ SFD in DOS HI or EDOS, must be assigned the name CHKP, 


Since the last checkpoint is preserved, the CHKP file must 
have sufficient size as to hold at least two checkpoints, i.e. 
at least twice the Core Store capacity. Note that checkpoints 
are recorded in 8~bit mode. The CHKP file may be used by 
any of the programs stored in the same volume. 


If, however, the user wants to preserve all checkpoints, or 
requires various checkpoints during a multi-program 
processing run, he can define additional checkpoint files, as 
sequential files (S type), which must be assigned, as file 
names, the name of the relevant program preceded by the 
name CHKP. 
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At the time of program start-up, the Order «LOAD in DOS II/EDOS 

or ePRL in DOS/TOS (or the Monitor) searches the file labels of the 
volume containing the program file, to select the area, defined by name 
CHKP, that can be reserved for the program to be started. 


One of the following cases may occur, depending on the result of this 
search. 


a) 


b) 


c) 


EXAMPLE: 
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The volume does not contain any file label whose file name begins 
with CHKP. 
In this case the DCKP cannot be executed and an error message is 
printed out, 


The volume contains a file label whose file name is CHKP, plus 
additional labels whose file names begin with CHKP but do not 
end with the name of the program to be started. 

In this case the checkpoint is recorded in the CHKP file. 


The volume contains a file label whose file name begins with 
CHKP and ends with the name of the program to be started. 
In this case the checkpoint is recorded in that file. 


write a checkpoint, with print option, 
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Copy Cylinder 


DESCRIPTION: 
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This macro-instruction is to be used only under DOS IL/EDOS. 


The macro-instruction COPY transfers the Index-Cylinder of 

a given file, residing on any volume, into a predetermined 
Index-File on the Basic Disc. This allows a significant time 
saving during processing. In a multi-volume file, this macro- 
instruction writes all the Index-Cylinders, appertaining to that 
file, into the Index File on the Basic Disc. The COPY macro- 
instruction must be written immediately after the relative OPEN 
of the file of which the Index Cylinder must be transferred. 


MACRO-INSTRUCTION FORMAT 


NAME: any name 


OPERATION CODE: COPY 


OPERANDS: - OP.1 symbolic name of file 


-OP.2 blank or C 


this operand is used to establish priority within many 
files with Index and can be coded as follows: 

blank - the file is processed with priority 

Cc - the file is not processed with priority 
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HOW IT WORKS: it is necessary to create a file label on the Basic Disc in order 
to reserve an area for the purpose of writing the Index Cylinders. 
The first form locations of this label must be "INDX", recording 
mode 8-bit (location 36) and must be reserved in the Index File, 
a number of cylinders at least equal to the total of Index Cylinders 
of the files to be used by the object program. 
Before transferring the Index Cylinders, the macro-instruction 
COPY executes the following controls: 


a) checks if the data file has been opened 
b) checks if the Index File label is present on the Basic 
Disc 


c) checks if in the Index File label there has been a 
sufficient number of cylinders reserved to contain all 
the Index of the file. 


If any one of the above checks results negative, the macro- 


instruction will be ignored and the control returns to the 
main program. 
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The UF/OF ZE/NZ indicators show the result of the COPY as follows: 


OF NZ 
1 0 (hexa 20) negative result. 
1 1 (hexa 10) positive result. 


At the end of the execution of COPY, the address of Index Cylinder, 
present in the area specified by the parameter FA of the FILE 
statement, is updated. 
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NEXT 


Change Volume 


DESCRIPTION: this macro-instruction is used, in sequential processing 
of multi-volume files, to open each volume in the file, 
following the first volume. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: NEXT 
OPERAND: symbolic name of file 


HOW IT WORKS: the macro-instruction NEXT is translated into a series of 
instructions which calls the routine which is located in 
cylinder zero, for opening the next volume. If a sequential 
file is recorded on two disc units which are used alternately, 
when the processing of one volume is completed, the NEXT 
"opens" the alternate volume. Before opening the next 
volume, the NEXT stops processing on a HLT instruction 
at address 01F6 to allow the operator to change volume if 
necessary. Since the same HLT instruction is used for 
changing magnetic tapes, the ALERT indicator (on DSUI10 
and DSUI30) or the SELECT /LOCK indicator (on DSU160) is 
lit up on the relevant disc unit, in order to differentiate 
between dise and tapes in disc/tape systems. 
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EXAMPLE: change volume and close sequential file ARCH, defined for reading 
in sequential processing mode mder DOS II or EDOS. 


Generar GD trectaic 


Saeter Tieton Fase OE 

PAE oreaayew orenano: 
pat “ 

fo 2{0] u 

ofafo i 

oslo PERMEAn EAN 2 
o|sjohyit Lert ¢ 

oud : ft ial 

oo0 zi} t im 

osolEMD LTE eel TE et eich [py emo Wel [Ar le 

ar 4 Re Heat eee i 

rzlo] i eae A a H 
i3)o] Cin Mita 

felol AQT Ft kage (elu, UL| | 

| 5| 0] zB [ridp: Lt 


EXAMPLE: change volume and close sequential file ARCH, defined for reading 
in sequential processing mode under DOS/TOS. 


cewenat GQ ueernie semeari ‘iensse El 
ha ek cess PRocra wane Pascammee [Bate] -"> = 
APS PROGRAMING FORK | i, i] 
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CLOSE 


Close Volume or File 


DESCRIPTION: this macro-instruction closes a volume or a file. Volume 
closing is always and only required in sequential processing 
of sequential files. File closing is required for any type 
of processing. 


MACRO-INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: CLOSE 
OPERANDS: - OP.1 symbolic name of file 


-OP.2 UL 
Optional operand used to set dise unit to Standby 
after the volume has been closed. Must not be 
specified if the CLOSE is followed by a NEXT, since 
the latter must be able to access that volume. The 
NEXT will then set the unit to Standby, in addition to 
performing its specific functions. 


HOW IT WORKS: the macro-instruction CLOSE is translated into a series of 
instructions which calls the routine which is located on 
Cylinder Zero, for closing a volume of a file. The closing 
procedure varies with the type of processing, as described 
in the two cases below: 
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Sequential Processing. 

The macro-instruction closes the volume being processed. 
In the case of file recording or updating, the HDR1 label 
is updated with the new boundaries reached both in main 
and overflow disc areas. In the case of file recording 
only, the CLOSE also causes empty pages to be recorded 
in the pair of tracks that was last used, if not fully 
occupied. 

The macro-instruction CLOSE, executed on a file 
declared absent by an LBC card, has no effect whatsoever 
{¥ in col. 49 of LBC card, in DOS/TOS; CO =co in 

DOS If/EDOS). 


Random or Random-Sequential Processing. 

All volumes in the file are closed at the same time. 
In the case of sequential files, if some updating was 
made in the overflow area, the file is updated with the 
new boundary. 


Before issuing a CLOSE macro-~instruction, the user must 
move the following characters to the first three positions of 
the WA field (or BA field, in the case of single-record pages): 


EOV - to close a volume 
EOF - to close a file 


If, the first three positions of the WA (or BA), are not 
recorded the macro-instruction CLOSE assumes the function 
of EOF. 
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Volume closing is only significant in the case of sequential 
processing of multi-volume sequential files, while file 
closing is also significant for the other types of file 
processing. 


The processing of any type of file must in any case provide 
for file closing. 


After recording a sequential file, the CLOSE writes on dise 
the last page still present, if any, in the Block Area, 


EXAMPLE: close the file INPUT and set the dise unit to Standby. 


GENERAL evectaic WWENTIFICATION pace muaoen L212] 


Faas PROCRAa WE Pacha | oar —]~ ANWAR 
APS PROGRAMING FORK 1. lee] 


orenation OPreRAnoS 
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Iv. EXAMPLE 


This example is valid only for ETOS users. Assume a card input file and 
three output files, two of which are on magnetic tape and one on the printer. 


The input file consists of two types of cards with, respectively, 50 and 51. 
The cards with code 50 make up the records of the first tape, the blocks. 

of which are formed by fixed-length records. The cards with code 51 make 
up the records of a second tape, the blocks of which are formed by variable- 
length records. The print file consists of records formed either by cards 
with codes other than 50 or 51 or by those cards whose numeric fields do not 
result as such when an appropriate check is made. 


Figure 9 - Block Diagram for APS example 
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ec) 
IN OUTPUT 


JF END-OF-FLE 


WY OUTPUT 


WRITE VARIABLE WRITE FIXED 
shes 


Figure 10 - Flow Chart for APS example 
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V. OPERATING PROCEDURES 


A. TRANSLATING THE SOURCE PROGRAM 
In TOS or ETOS 


To translate the APS source program, the assembly program uses two 
work tapes, WT1 and Wr2, mounted on any two tape units indicated on the 
. INT Order card. 


The source program can be punched on ecards or recorded on WT1. The 
assembly program is written on the System Tape which can be mounted 
on any tape indicated in Pilot 0 (which loads the supervisor). 

The object program is recorded on WT2. 


The assembly program is called into Core Store by reading the .APS 
Order card. When translating a program, the . APS card must be the 
first one placed on the card reader. It is the only card if the source 
program is on magnetic tape (WT1). If the source program is punched 
on cards, the .APS card must be followed by the source program cards. 
The source program must always start with the STRT card followed by 
the FILE cards, and end with the END card. 


After translation, the object program may be either inserted directly in 
the System Tape by the . API Order card (. SLI if the object program is 
a subroutine), or punched on cards by the .APP Order card (. SBP, only 
in ETOS if the object program is a subroutine). The program thus 
obtained may subsequently be transferred from cards to System Tape 
using the .STU Order card (. PSI only in ETOS if the program is a 
subroutine). 


Refer to TOS and ETOS manuals (see Appendix B) for the description of 
these Order cards. 
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After translation, the assembly program supplies a printout of the contents 
of the Entry Table and of the Name Table and a listing of the source program 
instructions together with the corresponding object program instructions. 


The Entry Table printout contains, in alphabetical order, all names used 
by the File Table and declared by the FILE instructions, The names 
specified as operands in the ORG instruction and in the CALL and 

the names (declared by the ENTRY instructions) that are common to 
various sections or segments. 


The Assembly Program assigns a field in Core Store to each name and 
prints field lengths and initial and final addresses, beside the associated 
names. It also prints the names of the subroutines that are called by the 
program and the initial addresses and the segment number where they are 
assembled in the main program. 


The Name Table printout contains, in alphabetical order, the names 

of the instructions (DC, DS, primary instructions, etc.) that are used 

in the program but not included in the Entry Table. To each of these 
names, as in the case of the Entry Table, the assembly program 

assigns a Core Store field, printing its length, initial and final addresses 
besides the associated name. 


During translation, the validity of the source program instructions is 
checked. If an error is detected, an appropriate error code is printed 
beside the incorrect instruction. A list of all possible error codes and 
of assembler messages appear in this manual, starting form page 299 
and325 respectively. 


The format of the .APS Order card is as follows: 


columns 1-4 .APS 
column 5 source program medium: 


%, if program is punched on cards 
2, if program is written on tape (WT1) 
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column 6 source program: 
Ks, if itis a program 
1, if it ig a subroutine 


columns 7-14 name of program or subroutine(*) 
(Under TOS) 

columns 15-49 program description printed as the 

heading of the object program listing 

columns 50-72 not used 

columns 73-16 optional ID sequence code 

columns 77-80 not used. 
(Under ETOS) 

column 15 optional instruction print out at end of 


program translation: 

/ or any character beside *, if the 
print out of all instructions is required 
*, if only the print out of the erroneous 
instructions is required. 


columns 16-45 program description printed as the 
heading of the object program listing 

columns 46-12, not used 

columns 73-76 optional ID sequence code 

columns 77-80 not used 


{*) The name of the subroutines must begin with character 'Y" and can not 
be longer than 6 characters; furthermore, if the subroutines contain a 
transcoding table its name must be six characters long ending with a "Y", 
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EXECUTING THE OBJECT PROGRAM 


In TOS or ETOS 


'To be executed, a user program must be located either in the System Tape 
or inthe Master Tape. The program is transferred to Core Store by the 

. PRL Order, and initiates its execution if it is recorded on ST or if it is 

the first of a series oMprograms on MT. The calling of each subsequent 
program from MT can be controlled by the Monitor of the preceding program. 


To modify the file table in Core Store or check the tape files, LBC (Label 
Control Cards) must be used before program execution. In this case, if the 
program to be executed is on System Tape, the . PRL Order card must be 
followed by the LBC cards, then by the END card. If the program to be 
executed is on Master Tape, the LBC cards, if required, must be used at MT 
generation time or when starting the program. 
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TRANSLATING THE SOURCE PROGRAM 


In DOS If or EDOS 


For source program translation, the assembly program may use, in 
addition to the System Disc, one or two other disc volumes of any kind. 


The source program may be punched on cards or recorded on dise (SD, 
WD or other volume, as specified by the ID parameter of the .APS 

Order card). The object program is always recorded in the largest free 
area on dise (SD, WD or other volume, as specified by the OD parameter 
of the .APS Order card). The source program on disc is destroyed during 
translation. 


The assembly program is called into Core Store by one of the following 
Order cards: 


.APS, to translate a program 
-SRC, to translate a normal subroutine 
.DSRC, to translate a disc subroutine. 


The following cards must therefore be loaded in the card reader: if source 
program on disc, Order card only; if source program on cards, Order card 
followed by the source program cards (starting with STRT card, followed 
by FILE cards as required, and ending with END card). 


When translation is completed, the object program may either be inserted 
directly in the System Disc, using the .API Order card (.CSI, to insert 
subroutine), or be punched on cards, using the .APP Order card (.CSP, 
to punch a subroutine) and subsequently, if required, be read from cards 
into the System Tape, using the . PPI Order card (. PSI to insert a 
subroutine). 


Refer to DOS II or EDOS manual (as listed in Appendix B of the present 
manual), for a description of these Orders. 
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At the end of translation, the assembly program supplies either of the 
following printouts: 


. the contents of the Entry Table and of the Name Table, and 
a listing of the source and object program (each two corresponding 
instructions appearing on the same line); See page 288 fora 


further explanation of the content of the Entry Table and Name 
Table. 


Or, a listing of the wrong instructions, if NL parameter specified 
in Order card, 


During translation, the source program instructions are checked for validity. 

If an error is detected, an appropriate error code is printed beside the 
incorrect instruction. A list of all possible error codes and of assembler 
messages appear in this manual, starting from page 299 and 325 , respectively. 


.APS, .SRC and .DSRC Order cards have the following formats: 
APS, pa [ D=id ] [ -0D=08 ] [x ][fomeom ] 
«sRc,sr [Did] [ ,op-od] [,NL] LoM-om 


-DSRC, sr [,D=id |] [,oD-04 ] [NE] [carom 7 


In specifying the parameters after the card names (.APS, .SRC and .DSRC}), 
the user must conform to the following conventions: 


1) The information in brackets is optional. 
2) All capital letters and the special symbols "comma" (,) and "equal" (=) 


must be punched as such, The lower case Jetters must be punched with 
the values indicated in paragraph 8) hereafter. 
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3) Parameter representation. 


- pn Name of program to be translated. A user program has 
a name of up to eight alphanumeric characters. 
An Operating System program has a name beginning with 
the character "period" (.). 


-sr Name of subroutine to be translated. (*) 


- I=id (Iaput Disc) Indicates that the source program is on disc, 
as specified by the value "id", that is, SD,LD,MD,BD, WD 
or the logical number of a disc unit. 

Operand ID absent indicates that the source program is 
punched on cards. 


= OD=od (Output Disc) Indicates that the object program must be 
recorded in the volume specified by the value "od", that 
is, SD,LD,MD, BD,WD, or the logical number of a dise 
unit. If this operand is absent, the object program is 
either recorded in SD if ID=id is also absent, or in the 
volume specified by "id". 


-NL. {No Listing) Indicates that program listing is not required. 
Incorrect instructions only are printed out, 


{«)the name of the subroutines must begin with character "Y" and can not be longer 
than 6 characters; furthermore, if the subroutines contain a transcoding table, 
its name must be 6 characters long ending with a "Y". 
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- CM=em (Comment) Specifies that 2 comment be printed on top 
of each sheet of the object program printout. "cm" 
is the comment to be printed, up to 30 characters in 
length, 
The comment can be changed in each section and/or 
segment following the first. This can be done by changing 
the comment (no longer than 30 characters) in the 
operands of ESCT and/or ESGM, 


NOTE: 


1) 


2) 


if OD=od is omitted, the largest free area in the System Disc (or in the 
disc unit specified by "id" parameter if ID=id is used) must be at least 
3 cylinders. 


it must be kept in mind that it is always convenient to utilize another dise 
(using OD=od) beside the System Disc (or beside the disc unit specified 
by "id"). This will improve the operation in time and space. This 
improvement will not exist if the dise unit specified in "od" is the 
System Dise or the same as the one specified in "id", 


If a second disc is used (beside the System Dise or the one specified in 
"id") thru OD=od, the user must provide a free area on the System Disc 
(or on the disc unit specified by "id") of at least one cylinder for the 
assembler. 
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EXECUTING THE OBJECT PROGRAM. 


In DOS II or EDOS 


To be executed, a user program must be located either in the System Disc 

or in the Master Disc. The program is transferred to Core Store and initiate 
its execution by the . LOAD Order, if it is recorded on SD, or by . MONITOR 
if it is recorded on MD. If the user wants to execute a serie of consecutive 
programs from the MD, he must load and initiate the first one with . MONITOR 
while the rest of the serie is controlled by the program monitor. 


The program's file table may be updated, either directly on the volume or 


at program execution time, using LBC (Label Control) cards after some 
appropriate Orders. 
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TRANSLATING THE SOURCE PROGRAM 
In DOS 


For source program translation, the assembly program uses a System 

Dise or, in addition to the SD a Work Dise (WD). The source program may 
be punched on cards or recorded on disc as specified by the colum 5 of .APS 
order card, The object program is always recorded in the largest free area 
of the SD. 


The assembly program is called into Core Store by .APS order card. When 
translating a program the .APS card must be the first one placed on the card 
reader. It is the only card if the source program is contained on disc; if 
source program is on cards the .APS card must be followed by the source 
program deck. The source program must always start with the STRT card 
followed by the FILE cards and end with the END card. 


After translation, the object program may be either inserted directly into the 
System Dise by .API Order Card (, SLI if the object program is a subroutine), 
or punched on cards by .APP Order card and subsequently be transferred from 
cards to the System Disc using a .SDU Order card. 


Refer to DOS manual (see Appendix B) for description of these Order cards. 


At the end of translation, the assembly program supplies a printout of the 
contents of the Entry Table, Name Table and a listing of the source program 
instructions together with the corresponding object program instructions 
(see page 288 for a further explanation of the content of Entry Table and 
Name Table). 
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During translation, the validity of the source program instructions ig 
checked. If an error is detected, an appropriate error code is printed 
beside the erroneous instruction. A list of all possible error codes and of 
assembler messages appear in this manual starting from page 299 and 325 
respectively. 

The format of the .APS Order card is as follows: 


columns i-4 APS 

column 5 source program medium: 
3%, program is punched on cards 
2, program resides on free area 
of System Dise and the SD is the only 
medium used. This is 2 typical case with 
TAB I and SPG 
3, program is punched on cards and a 
free area of the work dise is utilized 
4, program resides on the free area of 
the SD but a work dise is used for the 
assembly 

column 6 source program: 
i, if it is a program 
1, if it is a subroutine 


columns 7-14 name of program or subroutine(*) 

columns 15-49 program description printed as the heading 
of the object program listing 

columns 50-72 not used 

columns 13-76 optional ID sequence code 

columns 77-80 not used. 


(*)Phe name of the subroutines must begin with character "Y" and can not be 
longer than 6 characters; furthermore, if the subroutine contain a transcoding 
table, its name must be six characters long ending with a "Y''. 
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EXECUTING THE OBJECT PROGRAM 
In DOS 


To be executed, a user program must be located either in the System Dise 

or Master Disc. 

The program is transferred into core store and initiate its execution by . PRL 
Order, if it is recorded on the SD or MD. If the user wants to execute a series 
of consecutive programs from the MD,hemust load and initiate the first one 
with . PRL while the rest of the series is controlled by the program monitor. 


To modify the file table in Core Store or check the dise files, LBC (Label 
Control Cards) must be used before program execution. In this case, if the 
program to be executed is on System Disc, the, PRL Order card must be 
followed by the LBC cards, than by the END card. If the program to be 
executed is on Master Disc, the LEC cards, if required, must be used at 
MT generation time or when starting the program. 
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CHECK AND ERROR MESSAGES. 


Assembler Signals 


During translation, the assembler checks the source program for validity. 
One of the following error signals may result from this check. The signals 
(error codes) are printed beside the incorrect instruction (as described in 


the subparagraph a.b.c. e.) or right under (as described in d.) 


a. Checks of input/output macro-instructions 


DESCRIPTION ASSEMBLER ACTION 


Operand incorrect. The macro-instruction is not 
translated. 


Translation of the macro- 
instruction would exceed 
the maximum limit of the 
common-names table 
(ENTRY table). 


An undefined file or a 
file defined with an 
incorrect FILE is 
indicated as operand. 
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b. Checks on program imstructions 


DESCRIPTION 


Instruction operand specified 
by absolute address. (Valid 
only for DOS I, EDOS and 
ETOS) 


ASSEMBLER ACTION 


The instruction is translated in 
the normal way. 


D Double definition of an area The instruction is translated 
or a constant whose name in the normal way but only the 
has been declared in an name that was first defined, is 
ENTRY instruction. considered valid. 

E Unnecessary declaration of The instruction is translated 
a name in an ENTRY, that is in the normal way. 

a name has been declared (e.g. 
the name of a subroutine) 
which the assembler automati- 
eally inserts in the common- 
names table. (Valid only for 
DOS and TOS). 

F Invalid operands. If the instruction is a DC, it is 
not translated; otherwise it is 
translated into three HLT 
(0A00) instructions. 
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CODE 


I 


DESCRIPTION 


Operand substantially incorrect. 


Length error in the operands 
of a primary instruction or of an 
arithmetic macro-instruction. 


The store assignment counter 
has a value less than the 
minimum or greater than the 
maximum allowed. 


Instruction name incorrect. 


en 
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ASSEMBLER ACTION 


If€ the error is in the STRT, 
the assembler assigns to the 
program a STRT with the 
following operands: 

1800, 2 in DOS or TOS 

2700,2 in DOS T 

4000, 4 in EDOS 

2600, 4 in ETOS. 

If the error is ina DC, the DC 
is translated into blanks if the 
type C and into decimal zeroes 
if of type X. If it appears ina 
DS, the DS is not translated; if 
the error appears in another 
instruction, the instruction is 
translated into three HLT 
instructions (0A00). See NOTE. 


The instruction is translated but 
the operands will retain an 
incorrect length. 


The instruction is translated 
in the normal way. 


The instruction is translated 
but the name is not defined. 
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DESCRIPTION 


Operation code incorrect. 


Operation Code located at odd 
address in Core Store. 


A name defined more than once 
in the same section has been 
used as the operand of an 
instruction. 


Instruction sequence error, or 
program code is different from 
that of previous card. 


Name not defined. 
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ASSEMBLER ACTION 


The instruction is translated 
into three HLT instructions 
(0A00). 


The instruction is translated 
increasing its address by one. 


The instruction is translated 
in the normal way, and the 
name used as operand is 
translated into the address and 
length of the field that was 
first defined. 


e@ Ina program, the instruction 
is translated in the normal 
way. 

e Ina subroutine , the instruction 
is not translated. 


The instruction is translated by 
assigning the hexadecimal 
values 00 and 0000 to the length 
and address associated with the 
name. See NOTE. 
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ERROR 
CODE DESCRIPTION ASSEMBLER ACTION 


Subroutine error (valid only The instruction is not translated 

for EDOS). the name relative to the 
instruction is not entered into 
the ENTRY TABLE. 


NOTE: if I and U indicate macro-instruction errors, the names of the 
macro-instructions are not inserted in the Name Table. 
If I is relative to an ENTRY's operand name, that name and 
those following are not entered into the ENTRY TABLE, 
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ec. Checks on FILE declarative instructions, in ETOS 


DESCRIPTION ASSEMBLER ACTION 


General validity error. The instruction is not translated 
Files with un-numbered blocks 
and records with length less 
than 20. 


Files with numbered blocks 
and records with length less 
than 15. 


Incompatibility between type 
of tape and type of parity 
check; RM = 8 and EP. 


Incompatibility between type 
of tape and recording density; 
RM = 8 and PK #8 or PB. 


Incompatibility between type 
of tape and recording density; 
RM = 6 and PK =P. 


Variable-length records have 
been defined with parameter 
RC > 1023, 
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DESCRIPTION ASSEMBLER ACTION 


Length of block area is less 
than 80 characters (BK <80). 


The instruction is translated 
anyway. 


Length of block area 
(parameter BK) exceeds 
maximum provided for by 
EIOS (equal to 27, 000 
positions). 


The instruction is not translated. 


In files with numbered blocks 
and fixed-length records, the 
length of the block area has 
not been defined as a multiple 
of the length of the work area 


The instruction is translated 
anyway. 


+8 
[BK £ nc +5)}- 


In files with un-numbered 
blocks and fixed-length 
records, the length of the 
block area has not been 
defined as a multiple of the 
length of the work area 
(BK # n. RC). 
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d. Checks on FILE declarative instructions, in EDOS or in DOS IL. 


File instructions containing errors are not translated and error 
codes are printed out as listed in the following table. 
Each error code is preceded by the statement. 

INVALID FILE: ERROR N XX 


where XX is the error code 


Column 3 of the table below shows the types of peripheral units 
concerned, represented by the following symbols: 

R =card reader, P = printer, T = magnetic tape, D = dise. 
(symbols R and P refer only to EDOS) 


CODE DESCRIPTION "PERIPHERAL UNIT(S 
o1 File name wrong. 
02 Instruction format invalid, or 
operand symbol wrong. " 
03 Operand symbol wrong. % 
04 Address wrong, 2 
05 Length wrong. * 
06 Operand defined twice. v 
DV operand wrong. 
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ERROR | TYPE(S) OF | 
DESCR: 
CODE SCRIPTION PERIPHERAL UNIT(S) 
038 Operand not compatible with type of RPTD 
file. 
09 Obligatory operand not specified. m 
10 Use of reserved index register (6 or 1) i 
11 Block Area length less than 80 characters T 
(BK ¢ 80). 
12 MT operand wrong. % 
13 AT operand wrong. y 
14 RP operand greater than 999. sd 
15 RM operand other than 6 or 8 (in EDOS) 7 
or operand other than 8 (in DOS I) 
16 WA and RC operands not specified Ld 
17 WA and RC operands specified for a UN file " 
18 File with un-numbered blocks and record Li 
length less than 20, 
19 File with numbered blocks and record length s 


less than 15. 


(*) Valid only for EDOS. 
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ERROR 


TYPE(S) OF 
CODE DESCRIPTION 


PERIPHERAL UNIT(S 


20 File with variable-length records T 
(VL file), and RC parameter greater 
than 1023. 


21 Pile with variable-length records (VL file), " 
un-numbered blocks, and BK less than RC. 


22 File with variable-length records (VL file), ” 
numbered blocks, and BK less than (RC+ 5). 


23 File with fixed-length records(FL file), 
un-numbered blocks, and Block Area length e 
not a multiple of Work Area length 
(BK # 1. RC). 


24 File with fixed-length records (FL file), 
numbered blocks, and Block Area length be! 
not a multiple of Work Area length +5 
(BK # n. RC + 5). 


25 Tape recording mode and parity check * 
not compatible (RM = 8 and EP). 


26 Recording density (specified by operand " 
PK) wrong or tape recording mode not 
compatible with recording density 
{RM = 8 and PK # 8 or P). 
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TYPE(S) OF 


DESCRIPTION 
re PERIPHERAL UNIT(S) 


Recording density (specified by perameter T 
PK) wrong or tape recording mode not 

compatible with recording density 

(QM = 6 and Pk # 2,5 or 8). 


Block Area length (parameter BK} 

greater than allowed by EIOS (27000 octets 
for EDOS and 4096 for DOS II) 

FL or VL specification absent. (*) 


EV specification absent.(+) 


BA specification absent. (+) 
BK specification absent +) 


UN specification rejected.(*) 
BK operand greater than 80, or = 0.4 


File with variable-length records 
(VL file) and BK<3, or file with fixed- 
length records (FL file) and BK<2. 


@ Valid only for EDOS 
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YPE(S) OF 


DE 
SCRIPTION PERIPHERAL UNITY (S) 


File with variable-length records P 
(VL file) and BK> 168, or file with 
fixed-length records (FL file) and 
BK > 162. (*) 


Record format (VL, FL or UN) speci~ 
fication absent. 


Invalid specification of file access mode 
(AM # S, R or M). 


Recording mode specification invalid 
@M # 6 or 8 in EDOS; RM # 8 in DOS 0). 


File Organization (type of file) specification 
invalid (FO # S or R). 


MT or AT specification, invalid (other than 0 
to 9 and A to F in EDOS; other than 0 to 7 in 
DOS 1). 


FE specification invalid 
(FE # 1to 9 in EDOS) 
(FE # 1to7in DOS 


RP specification invalid (RP > 999). 


RI specification invalid (RI 4 CH, PG, SS or MS) 


(*)valid only for EDOS. 
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TYPE(S) OF 
Type of file not compatible with method D 


of record insertion in file 
{FO =R and RI = CH). 


Index register specified by WA operand, " 
but file is not sequential (FO # 8) or 

is not processed sequentially (AM # S); 

or, Index register specified by WA, file 

is sequential (FO = 8) and processed 

sequentially (AM = 8), but RI or UP 

operand was specified.(*) 


RI=CH, but KS not specified. a 


AT =N not compatible with Ht 
AM =R or M. 


Sequential access (AM = 8) not compatible 
with operand FE specification. 


Random file (FO = R) not compatible 
with variable-length records (VL file). 


Block Area length less than 75 octets ne 
(BK 4 75). 


| 


(*)valid only for EDOS 
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DESCRIPTION 


TYPE(S) OF 
PERIPHERAL UNIT(S) 


In random or random~-sequential processing 
the Block Area length has acceded the 
following limits: in EDOS is greater than 
5760 octets (BK> 5760) if 8-bit recording 
mode (RM = 8), or greater than 7680 
octets (BK> 7680) of 6-bit recording 

mode (RM = 6). 


In DOS II is greater than 2880 octets 

(BK > 2880) 

Single-record pages (UN file) not compatible 
with WA or RC specification. 


Variable- or fixed-length records (FL or VL 
file), but WA or RC operand not specified. 


Variable-length records (VL file), but 
Work Area length greater than Block Area 
length (RC > BK). 


Fixed-length records (FL file) not compatible 
with value of RC operand (RC 2). 


Fixed-length records (FL file) not 
compatible with value of RC operand 
(RC > 4096). 


Fixed—length records (FL file), but Block Areg 
Jength is not a multiple of Work Area length 
(BK £ n. RC). 


D 
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TYPE(S) OF 
DESCRIPTION i PERIPHERAL UNIT(S 
Variable-length records (VL file) not D 

compatible with value of RC operand 


(RC > 1023). 


Variable-length record (VL file) not " 
compatible with value of RC operand 
@c<4). 


BK specification is not a sub-multiple m 
of the following: 

20 sectors (1,2,4, 5,10, 20) in EDOS. 
10 sectors (1,2,5,10) in DOS H. 

In a file to be processed in random or 
random-sequential mode (AM = R or M). 


UP not compatible with NY. " 


User routine, as specified by operand 
EV, not compatible with random process- 
ing (AM = R). 


User routine not specified (by EV operand), 
in sequential or random -sequential 
processing (AM = § or M). 


UP not compatible with RP. " 


File Index field in Core Store was specified u 
(by FA operand) in sequential processing 


{AM = §). 
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ERROR TYPE(S) OF 
CODE DESCHIETION PERIPHERAL UNIT(S 


80 File Index field in Core Store was specified D 
(by FA operand) in random file (FO = R). 


81 Record key field in Core Store was specified Ly 
(by KA operand) in sequential processing 
(AM = 8). 


82 FA operand (file Index Field in Core Store) u 
was specified, but KA operand (record key 
field in Core Store) was not. 


83 KA operand (record key field in Core Store) " 
was specified, but KS operand (key size) was 
not. 


84 KS operand (key size) was specified in us 
sequential processing (AM = §), and RI=. 
PG, SS or MS. 


85 Record key size greater than 255 octets a 
(KS > 255). 
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ERROR TYPE(S) OF 
DESCRIPT 
CODE AETION PERIPHERAL UNIT(S) 
86 File Index field specification (FA operand) D 


not compatible with one of the following 
combined specifications: 


6-bit recording mode (RM = 6) 
and key size greater than 38 octets 
(KS > 38), only with EDOS. 


.  8-bit recording mode (RM = 8) and 
key size greater than 28 octets 


(KS > 28). 


87 In file updating (UP specification), Core ‘i 
Store field for receiving records (RA 
operand) was specified, without defining 
method of record insertion (RI operand) 


88 In file updating, Core Store field for a 
receiving records (RA operand) was 
specified, but UP parameter is absent, or, 
UP present, but method of record insertion 
(RI operand) not specified. 


89 Sequential file specification (FO = 5) 
not compatible with RI = PG, SS or MS. ult 


90 Random file specification (FO = R) not " 
compatible with random -sequential processin; 
specification (AM = M). 
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TYPE(S) OF 
CODE Teo PERIPHERAL UNIT(S} 
91 The access method has been specified as D 
random or sequential-random (AM=R or M) 
without defining the parameter DA. 
98 A FILE statement has been used on a 
subroutine. ( *) RPTD 
99 Error condition, due to one of the D 


following reasons: 


more than 20 tape and/or disc FILE 
statements have been defined, in EDOS 
more than 10 in DOS 1 


more than one card read file has been 
defined, (only in EDOS) 


. more than one print file has been 
defined, (only in EDOS) 


. tape or disc FILE instructions, 
follow the read and print FILE's 
(only in EDOS) 


the file table, generated by the FILE 
instructions, is more than 2016 octets 
in length (in EDOS) or 1152 (in DOS I). 


(#)Valia only for EDOS. 
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e. Checks on FILE declarative instructions in DOS or TOS. 


1) For tape and dise files. 


DESCRIPTION 


F A mistake has been made in the format 
of the operand field specifications: 


ASSEMBLER ACTION 


The FILE statement is not 
translated. 


- Incorrect parameter (e.g. RN = 6 
instead of RM = 6) 


~Operand length specification is non- 
numeric 


~ incorrect punctuation between oper- 
ands 


- Incorrect order of operand definitions 
(e.g. BK has been defined following BA) 


- Character C missing in column 72 


- The operation code field for the second 
and/or subsequent FILE statement card 
is not blank, 
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2) 


For tape files 


ERROR 
CODE 


DESCRIPTION 
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ASSEMBLER ACTION 


a 


~ The Block Area and Record Area 
dimensions (BK and RC) are greater 
than the maximum or less than the 
minimum. 


- The length (RC) of the WA is not a 
submultiple of the length (BK) of the 
BA minus five when fixed-length 
records are used. 


Incompatibility between writing mode 
and density. That is, having defined 
RM = 6 (7-track) PK is not 2,5 or 8; 
or having defined RM = 8, PK is not 
8or PB, 
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The statement is translated 
with the lengths as they are 
specified. 


The statement is not 
translated. 


3) 
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For disc files 


DESCRIPTION ASSEMBLER ACTION 


An alternate unit (AT = n) cannot be 
specified for a file defined as random 
or mixed (AM = R or M). 


The statement is not 
translated. 


The number of additional volumes (FE=n) 
cannot be specified for a sequential file 
(AM = 8). 


The statement is not 
translated. 


The variable length record (VL) cannot 
be specified for random files (FO = R). 


The statement is not 
translated. 


The length (BK) of a page record is less 
than minimum of 80. 


The statement is translated 
with the length as specified. 


The length (BK) of a page record is 
greater than maximum of 4096. 


The statement is not 
translated. 


If the packing mode is full track (PK=F) 
and the recording mode is 8-bit mode 
(RM = 8), the length (BK) of the page 
record cannot be greater than maximum 
of 2235. 


The statement is not 
translated. 


07 


The statement is not 
translated. 


If the packing mode is full track (PK=F) 
and the recording mode is 6-bit mode 
(RM = 6), the length (BK) of the page 
record cannot be greater than maximum 
of 2980. 
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ERROR 


CODE DESCRIPTION ASSEMBLER ACTION 
08 A logical record store arca (WA = The statement is not 
address) cannot be specified for files translated. 

formed of page records (UN). 
og The area reserved for logical records The statement is not 
(WA) has not been specified for fixed translated. 
length or variable length files (FL or 
VL). 
10 The length (RC) of the area reserved The statement is not 


for the logical record (WA) is greater translated. 
than the length (BK) of the area 
reserved for the page record (BA). 


11 


The length (RC) of the area (WA) The statement is not 
reserved for the logical fixed length translated. 
record (FL) is less than 2. 


12 


The length (RC) of the area (WA) The statement is not 
reserved for the logical fixed length translated. 

record (FL) is not a sub-multiple of 
the length (BK) of the area (BA) 
reserved for the page record. 


13 


The length (RC) of the area (WA) The statement is not 
reserved for the variable length translated. 

logical record (VL) is greater than the 
maximum of 1023. 


The length (RC) of the area (WA) The statement is not 
reserved for the variable length logical translated. 
record (VL) is Jess than 4. 
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ERROH DESCRIPTION ASSEMBLER ACTION 
CODE 

15 The length (BK) of the area (BA) The statement is not 
reserved for the page record of a translated. 
random file (AM =R or M) is not 
equivalent to 20 sectors or a 
sub-multiple of 20 sectors. 

16 For an index sequential file (FA) the The statement is not 
length (BK) of the area (BA) reserved translated. 
for the page record is less than 200 
for RM = 6 or 150 for RM = 8. 

17 An end-of-volume routine (EV) cannot The statement is not 
be specified for a random file (AM=R).| translated. 

18 An end-of-volume routine (EV) has not The statement is not 
been specified for a sequential (AM=S) translated. 
or mixed (AM=M) file. 

19 A retention period (RP) can not be The statement is not 
specified with files which are in update ; translated. 
(GP) mode. 

20 An index sequential file operand (FA) The statement is not 
can not be specified if the access mode | translated. 
is sequential (AM = §). 

21 An index sequential file address (FA) The statement is not 
can not be specified for a random file translated. 
(FO=R), 

22 A key area (KA) cannot be specified for} The statement is not 


a sequential file (AM = S). 


translated. 
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CODE DESCRIPTION ASSEMBLER ACTION 
23 A key area (KA) must be specified for The statement is not 
a sequential file with index (FA). translated. 

24 A key size (KS) must be specified when | The statement is not 
a key area (KA) has been defined, translated. 

25 If the key size (KS) has been defined for | The statement is not 
sequential access mode (AM=S), the translated. 

record insert method must be defined 
as chaining [RI = CH). 
26 If the recording mode for a sequential The statement is not | 
file with index (FA) is six (RM = 6), the | translated. 
key size (KS) must not be greater than 
20. 
27 If the recording mode for a sequential The statement is not 
file with index (FA) is 8 (RM = 8), the translated. 
key size (KS) must not be greater than 
15. 
28 Updating a file (UP) with record inserts | The statement is not 
requires the specification of a transiated. 
record insert area (RA). 
29 A record insert area (RA) has been The statement is not 
specified without the specification for translated. 
an update file (UP); 
or 


A record insert area (RA) has been 
specified, the file is to be updated (UP), 
but the method of insertion (RI) is 
missing. 
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DESCRIPTION 


If the file organization is sequential 
(FO = 8), the record insertion method 
must be chaining (RI-CH). 


A file with random organization (FO=R) 
cannot be updated (UP) by chaining 
(RICH). 


Update files (UP) must be verified 
(NV) cannot be specified. 
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ASSEMBLER ACTION 


The statement is not 
translated. 


The statement is not 
translated, 


The statement is not 
translated. 


Assembler Messages 
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The assembly program supplies messages to indicate that some condition 
has occurred, requiring operator's attention, for example: peripheral 
error or out-of-service conditions, , APS card errors as detected by the 
Operating System, area reserved for translation on disc either missing 
or not sufficient, end of translation with indication of errors, if any. 


a. Messages in ETOS 


2401 *UNIT X: PERSISTENT 
ERROR 


2402 *UNIT X: OUT OF 
ORDER 


2450 +*TRANSLATION TYPE 
WRONG 
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Persistent error on unit with 
select number X. 

Program execution halts at 
address 02A6; ID Sequence 
Validity Switch set to NO. 


Unit out of service. 

If this condition occurs after 

a rewind command, the program 
stops on a wait HLT at address 
ODA. 

The operator can restart the 
unit and press START. 

if the condition occurs after 

a read or write instruction, 

the program halts at address 
02A6 with ID Switch set to NO. 

Tf it takes place in a final rewind 
operation, the program terminates 
in the normal way. 


Column 5 or column 6 of the Order 
card regarding the translation of a 
program contains an invalid character. 
Program execution stops at address 
02A6. ID Switch set to NO. 


2451 


2452 


2454 


2498 


2499 


*SUBROUTINE TYPE. WRONG 


*INVALID STRT CARD 


*INVALID APS TRANSLATION 


*INVALID SUBROUTINE 
TRANSLATION 


*END OF SUBROUTINE 
TRANSLATION 


*END OF APS TRANSLATION 
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Column 5 or column 6 of the 
order card regarding a 
subroutine transiation contains 
an invalid character. 

Program execution halts at 
address 0246. 


DD Switch set to NO. 


The STRT program card is 
incorrect or missing. Program 
execution halts at address 02A6. 


ID Switch set to NO. 


The translation is ended but the 
program contains errors. 
Program execution halts at 
address 02A6. 


ID Switch set to NO, 


The translation is ended but 
the subroutine contains errors. 
Program execution halts at 
address 02A6. 


ID Switch set to NO. 


The subroutine translation is 
ended, The order has been 
executed correctly. 


The program translation is 
ended. The order has been 
executed correctly, 


Messages in EDOS 


*O0S*51001*DU=N PERSISTENT 
ERROR 


*OS*51002*DU=N PERSISTENT 
ERROR 


¥*O5*51003*DU-N OUT 
OF ORDER 


*05*51004*DU=N POSITIONING 
ERROR 


*0$*51020*IF NOT FOUND 


*0S*51021+ IF UNKNOWN 


*OS*51022* If LENGTH WRONG 
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Persistent read error on disc unit 
with logical number N. Processing 
stops at address 02A6, ID Switch 
set to NO. 


Persistent write error on disc unit 
with logical number N. Processing 
stops at address 02A6. ID Switch set 
to NO. 


Disc unit with logical number N is 
out of service. Processing stops 
at address 02A6. ID Switch set to 
NO. 


Positioning error on dise unit with 
logical number N. Processing stops 
at address 02A6. ID Switch set to NO. 


Order card parameter (Identification 
Field), obligatory but not punched. 
Processing stops at address 02A6. 
ID Switch set to NO. 


Parameter (Identification Field) 
invalid. Processing stops at 
address 02A6. ID Switch set to NO. 


. Length specified by parameter 


(dentification Field} wrong. 
Processing stops at address 02A6. 
ID Switch set to NO. 


*OS*51024*ERROR FROM..... 


*OS*510254*IF = XXXXXX 
NOT ACCEPTED 


*O5*5 1030*ID/OD=XX 
ILLEGAL 


#0S*51031*ID/OD=N 
PFL NOT FOUND 


*05*51032+ID=MD/SD/LD 
NOT FOUND 
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Inappropriate parameter specified 
in Order card. This card is printed 
out starting from the first wrong 
column (up to 68 characters may be 
printed). Processing stops at 
address 02A6. ID Switch set to NO. 


Specified parameter (Identification 
Field) has not standard format. 
Processing stops at address 02A6. 
ID Switch set to NO. 


Information punched XX, not accepted 
Processing stops at address 02A6. 
1D Switch set to NO. 


Program File Label not found on 
unit with logical number N. 
Processing stops at address 02A6. 
ID Switch set to NO. 


Code (MD,SD or LD) specified by 
Order Card is not found in program 
file label. Processing stops at 
address 02A6. 

ID Switch set to NO. 
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¥08*51033*ID/OD=N=MD/SD/LD Wrong code (MD, SD or LD) in program 
NOT ACCEPTED file label on unit with logical number N. 
Processing stops at address 02A6. 
ID Swtich set to NO. 


408+51036*ID/OD=WD The Wrok Disc was not defined. 
UNDEFINED Processing stops at address 02A6. 
ID Switch set to NO, 
#0S$*51108*IN VALID 'STRT' First Card of source program is 
CARD not a STRT. Processing stops at 
address 02A6. ID Switch set to NO. 
*O8*51133*DU=N On disc unit with logical number N, 
WORK SPACE available area missing or not 
OVERFLOW sufficient. Processing stops at 
address 02A6. ID Switch set to NO. 
¥OS*51144*NL=XX NL ineorrectly punched XX. 
NOT ACCEPTED Processing stops at adddress 02A6. 


ID Switch set to NO. 
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+*08*51300*DU=N OBJECT PROGRAM Ondisc unit with logical 
OVERLAYS SOURCE PROGRAM number N, an untranslated 


*08*51301*DU=N TRANSLATION 
IMPOSSIBLE WITHOUT 
WORK DISO 


*0S*51302*INVALID 
. APS TRANSLATION 
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part of the source program was 
destroyed during assembly, 
owing to available area not 
sufficient. Processing stops at 
address 02A6. ID Swtich set to 
NO. 

Rewrite source program on a 
volume with larger available 
area, then repeat the assembly 
procedure. 


On dise unit with logical 

number N, the translation 
requires a Work Disc. Processing 
stops at address 02A6. 

ID Switch set to NO. 


Translation completed, but 
program contains errors. Pro- 
cessing stops at address 02A6. 
ID Switch set to NO. 


¥#OS*51303*INVA LID 
«SRC TRANSLATION 


*OS*51304*INVALID 
«DSRC TRANSLATION 


*OS*51999*END OF .APS 


*OS*51999*END OF .SRC 


*O8*51999*END OF .DSRC 


NOTE: 
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Translation completed but subroutine 
contains errors. 

Processing stops at address 02A6. 
ID Switch set to NO. 


‘Translation completed, but the dise 
subroutine contains errors. 
Processing stops at address 02A6. 
ID Switch set to NO, 


Program translation successfully 
completed. 


Subroutine translation successfully 
completed. 


Dise subroutine translation 
successfully completed. 


The messages 51032 and 51033 are proceded by the header label as 


follows: 


*05#51900*ID/OD = N: HDR1......-6000ee0ee- es 
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Messages in DOS E 
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These messages are equal to the messages under paragraph b. (in EDOS). 
The only difference is in the first four characters instead of being *OS* 
are *DOS. 


Messages in DOS 


3510 


3512 


3513 


3514 


3515 


*STRT CARD NOT FOUND 


*INVALID APS 
TRANSLATION 


*OVER ON SYSTEM DISC 
TRANSLATION IMPOSSIBLE 


*OUTPUT FILE OVERLAPS 
SOURCE PROGRAM-TRAN- 
SLATION IMPOSSIBLE 


*ORDER CARD-COLUMN 05~- 


ERROR. 
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STRT card is erroneous or 
missing. 


Translation has been completed, 
the program contains errors. 


The free area in the System Disc 
is too small to contain the 
compilation. 


The free area in the System Dise 
is too small to contain the compila- 
tion of a TAB or SPG program. 


Column 5 of the order.card contains 
an invalid character or the Work 
Disc is out of order. 


3599 


*END OF APS TRANSLATION 


Messages in TOS 


3510 


3512 


3515 


3599 


*STRT CARD NOT FOUND 


*INVALID APS TRANSLATION 


*ORDER CARD-COLUMN 


05/06 - ERROR 


*END OF APS TRANSLATION 


333 


APS REFERENCE MANUAL 


The translation has been 
completed correctly. 


STRT card is erroneous or 
missing. 


Translation has been completed, 
the program contains errors. 


Columns 5 or 6 of the order card 
contain an invalid character. 


The translation has been completed 
correctly. 
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3, Halts during execution of the object program 


a. Halts caused by tape-EI0S. 


HLT 


ADDRESS DESCRIPTION OPERATOR'S ACTION 


Signais that a checkpoint Press START to restart 
has been written. processing. 


This halt occurs if the Press START for a maximum 
programmer has not of 5 more read or write 
provided the OE routine attempts. 

for checking errors. 

If signifies persistent error 

at input or output. 


Unit out of service. Impossible to continue. (e) 
This halt takes place if the 

programmer has not provided 

the OE routine for checking 

errors. 


Checking of block number Press START for a new 

during input, has failed. read attempt. 

This halt occurs if the ©] 
programmer has not provided 

the OE routine for checking 

errors, 
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HLT ADDRESS 
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01EC 


OPERATOR'S 
DESCRIPTION ACTION 
- Unit out of service - If during file opening, 
- read error press START to restart 
- write error. file opening. 
This halt occurs during file - If during checkpoint 
opening or during execution execution, press START 
of a checkpoint. to attempt reading or 
writing again. 
This HLT occurs during Mount the correct tape 
file opening. and press START. 
It can have one of the following 
meanings: 
~ the first tape label is not 
INT1 (or VOLI) 
- the second tape label is not 
the HDRi 


- after the HDR1, the TM is 
not present. 


One of the comparisons made Mount the correct tape 
between the information on the and press START. 
HDR1 label and that in the files Or, to continue, turn on 
table has given a negative result, SWITCH 2 and press 
START. 
In this case, the program 
stops on a wait HLT. At 
this point, turn SWITCH 2 
off and press START again. 
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OPERATOR'S 
ACTION 


Press START to resume 
program execution from the 
instruction immediately 
following the macro- 
instruction concerned 
(which has no effect). 


HLT ADDRESS DESCRIPTION 


O1F2 An OPEN macro-instruction 
has been commanded on a 
file already "open". 


A NEXT macro-instruction has 
been commanded on a file that 
has not been "closed". 


A CLOSE macro-instruction has 
been commanded on a file already 
closed. 


A CHKP macro-instruction has 
been commanded on a file that ia 


not opened in output. 
o1r4 Error in the final check of the To continue processing 
blocks processed in a standard set SWITCH 2 and press 
input file. START. At this point the 
program again stops on 
a wait HLT. Then turn 
off SWITCH 2 and press 
START again. 
01Fr6 There is a halt for reel change, Mount new tape and press 
START. 


This halt is valid for TOS only. 
In case of a data file following 
a program file, the following 
errors may occur: 

- the file is not standard. 


- the closing of a file has been 
requested with an EOV. 


Impossible to continue. 
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b. Halts caused by dise-EIOs, 


HLT ADDRESS DESCRIPTION 


A checkpoint has been recorded, 
when the HT operand was 
specified in DCKP macro- 
instruction. 


OPERATOR'S 
ACTION 
Press START to resume 
processing. 


Press START to make 
up to five more attempts. 


Persistent error during 
positioning operation. 
This halt occurs if the 
programmer has not 
provided the OE routine 
for checking errors. 


Press START to make 
five more attempts. 


- Unit out of service 
- Read error 

- Write or verify error. 
This halt occurs if the 
programmer has not 
provided the OE routine for 
checking errors. 
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HLT ADDRESS 


DESCRIPTION 


~ Unit out of service 

- Read error 

- Write or verify error. 

The SELECT/LOCK (DSU160) 
or ALERT (DSU110 or DSUL30) 
indicator is lit up. This halt 
occurs during file opening or 
checkpoint recording. 


Wait halt to allow change of 
volume (halt caused by NEXT 
macro-instruction). 


DCKP macro~instruction 
issued, but the CHKP file 
(for checkpoint recording) 
was not assigned on System 
Disc. 
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OPERATOR'S 
ACTION 


Check the disc unit and 
reset the light indicators; 
then, in the case of file 
opening, press START to 
continue processing. In 
the case of checkpoint 
recording, press START 
to attempt recording again. 


Mount the new Dise Pack, 
then press START. 


By pressing START, 
processing continues without 
executing the DCKP. 


HLT ADDRESS 


DESCRIPTION 
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OPERATOR'S 
ACTION 


Incorrect use of one of the 
following macro-instructions. 


- OPEN, if the file is 
already open, 

- CLOSE, if the file is 
not open, 


- NEXT, if the file was 
not closed on preceding 
volumes. 


The checking of the file 
label against the file table, 
has failed. 
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By pressing START, 
processing continues and 
the incorrect macro- 
instructions are 
disregarded, 


Mount the correct volume, 
then press START. To 
ignore this error signal, 
turn SWITCH 2 "on", and 
press START: by turning 
SWITCH? "off", processin; 
is continued. 
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OPERATOR'S 
HLT ADDRESS | DESCRIPTION ACTION 
O1FE Halt due to one of the following Mount the correct volume, 
errors: then press START, 
- Some parameters in file label 
are not compatible with other 
parameters in file table (for 
example, specification of 
random file in HDR1 label, 
and specification of variable- 
length records in file table) 
- it has been specified absent Impossible to continue. 
(Y.....) a file not in 
sequential access nor in 
input. 
0200 Halt due to one of the following Mount the correct volume, 
errors: then press START. 


- volume label VOL1 not found 
in the volume being processed 


- required file label not found in 
the volume being processed. 
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PART VI - APPENDIXES 


A. GLOSSARY 


Binary Numbers 


A numbering system using a base of two digits or 
"bits" (0 and 1) as compared to the decimal system 
which uses a base of ten digits (0 to 9). 


An item of information normally treated as an entity 
by hardware (physical record). On magnetic tapes, a 
series of characters that are read or recorded during 
a single data transfer operation. 

Each block is followed by an inter-block (or inter- 
record) gap set to binary zero. 
Block Area Core Store area used for temporary storage of a Block 
or Page before and after processing. 


Block Number See "Block Sequence Number", 
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Block Sequence 
Number 


Card Read Area 


Connector 


Decimal Form 


Disc Area 


Dise Operating 
System (DOS) 


Disc Operating 
System (DOS I) 


Disc Sequence 
Number 


Dise Serial 
Number 


Dise Unit 
Controller Name 
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DEFINITION 


Decimal number (five digits in length) specifying the 
sequential order of a data block within a tape. 
Recorded in the first five characters of a numbered 
block, If not present, the block is called un-numbered. 


Field in File Table into which card contents are read. 


The GE 130 has four outlets (connectors) to which the 
peripheral units are physically tied. The connectors 
are switched electronically between I/O channels, 
under program control. 


Representation of the digits 0 to 9. 


Bight-octet field in Core Store, where the address of a 
record, page or track is supplied, 


Software provided for disc-oriented GE 115 system using 
DSS130 disc; it can process also data files on magnetic 
tapes. 


Software provided for disc-oriented GE 115 System using 
DSS110 or DSS161 dise; it can process also data files on 
magnetic tapes. 


Decimal number (four digita in length) specifying the 
sequential order of a Dise Pack (volume) in a File. 
Recorded in File Label. 


Alphanumeric identifier of Disc Pack, recorded in Volume 
Label. Six characters long. 


Controller identifier contained in Disc Unit Name. Fixed 
value, depending on peripheral configuration. 
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TERM DEFINITION 

Dise Unit Number assigned to a dise unit by the .DNA Order of 
Logical DOS, DOS 0 or EDOS. 

Number. 

Dise Unit Used by PER or PERI instructions to address a disc unit. 
Name Fixed one-octet value, depending on peripheral configuration. 


Extended Dise 
Operating 
System(EDOS) 


Extended Tape 
Operating 
System (ETOS) 


File Absent 


File Code 


File Creation 
Date 


File Header 
Label 


File 
Identification 


Code (Symbolic 


Name of File) 
File Name 


Software provided for disc-oriented GE 120 and GE 130 and 
GE 130 systems, using DSS110 or DSS161 disc, it can process 
also data files on magnetic tapes. 


Software provided for tape-oriented GE 120 and GE 130 systems. 


Option specified in LBC card (Y incol.49, under DOS, TOS or . 
ETOS, CO=NNNNYN under DOS II or EDOS), to the effect 
that the file be considered as absent in a given operation. 


See "File Identification Code". 


Date File was generated. On tape, it is recorded in File 
Header Label and in File and Volume Trailer Labels. On 
Disc, it is recorded in File Label. 


On tapes, an 80-character block of data identifying the 
beginning of a Standard File. Follows the Tape Header 
Label. 


Alphanumeric File identifier used within a program 
(6 characters long). 


12-character alphanumeric File Identifier. On tape, it is 
recorded in File Header Label and in File and Volume 
Trailer Labels. On disc, it is recorded in characters 5 to 16 
of File Label, 
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File Purge Date indicating the day after which the File can be deleted. 

Date On tapes, it is recorded in File Header Label and in File and 
Volume Trailer Labels. On disc, it is recorded in File Label. 

File Retention| Length of time during which the File must not be deleted 

Period (expressed in number of days). 

File Serial Six-character alphanumeric field, used in addition to 

Number Symbolic Name, to further identify a File. On tape, it is 


recorded in File Header Label and in File and Volume 
Trailer Labels. On disc, it is recorded in positions 22 to 


27 of File Label. 


File Symbolic See "File Identification Code". 
Name 


File Table Table generated by the FILE instructions and containing 
the characteristics of the file(s) required by a program. It 
is recorded just before associated program. 


File Trailer On tapes, an 80-character block of data identifying the end 
Label (EOF1) of a Standard Data File and the end of a tape. It contains 
the quantity of blocks in the File. 


File, empty Dise area, reserved for File yet to be recorded, and 
containing empty pages. 


File, Standard| Tape File containing standard blocks, standard Header 
(VOL1 and INT1, and HDR1) and Trailer Labels (EOVI or 
EOF1) and Tape Marks (TM's). 


Head Position; Disc unit actuator arm carrying the read/write heads. 
ing Mechanisny 
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Hexadecimal 


Hexa, 


ID Sequence 


ID Sequence 
Validity 
Switch 


Megal 


Index 
Registers (or 
Registers) 


Invalid 
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DEFINITION 


Conventional notation for designating the 16 possible bit 
configurations of a quartet. Hexadecimal values are: 
0, 2, 2, 8, 4, 5, 6, 7, 8, 9, A, B,C,D,E, and F, 


This notation can be used in card punching to introduce 

in Core Store any quartet configuration: one hexa. character 
per column, two hexa. characters per octet, This is 
commonly referred to as "punching in hexadecimal". 


. Alternatively, a graphic (rather than a hexadecimal) 
character having a right quartet configuration in Core 
Store equal to the desired configuration can be used. These 
cards are said to be punched in "pure hexadecimal". 

(See GE 100 Graphic Character Set in GE 130 Reference 
Manual, Appendix B). 


Abbreviation for Hexadecimal. 


This code is used to identify a sequence of Order cards being 
used to perform a series of inter-related operations. 


Octet in System Reserved Area which is tested for the correct 
or incorrect execution of a program. 


Refers to an item of information which is not accepted as a 
valid representation by the machine design or by a specific 
routine or program. 


Special purpose two-octet fields in Core Store normally used 
for address modification in EDOS or ETOS, In GE 120 and 
GE 130 eight registers, numbered from 0 to 7, are availablo. 


See "Illegal". 
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TERM DEFINITION 


I/O Channels Input/output Chamnels. The electronic data paths used for 
tying peripheral units to the CPU, allowing independent 
and simultaneous transfer of information. 


Label, Void File Label recorded on disc using an appropriate Order. 
Only contains the name "HDR12" in the first four positions 
and the character "V" in position 54. 


Languages, The 115 software, besides the languages used in DOS and TOS 
APS 115 includes two APS versions; which are not part of the operating, 
Systems: 


- Basic APS, which is an one-to-one assembly program; 


- Extended APS, which is an expansion of Basic APS as it 
provides some macro-instructions. 


LBC Cards These cards are used to update the File Table concerning 
the Data Files required by the User Program. 


Library Dise Dise Pack used by DOS, DOS II or EDOS, containing all User 


(LD) (and Utility) programs in working order. 

Library Tape Tape used by TOS or ETOS, containing all User (and Utility) 
(LT) programs in working order. 

Leop See "VFU (Vertical Format Unit)". 


Master Disc Disc Pack used in DOS, DOS II or EDOS, containing all User’ 
(MD) (and Utility } and EDOS programs needed for operation during 
a specific working period (shift, day, week). The programs 
contained in the MD have been debugged and are arranged 
in proper sequence for carrying out the planned schedule of 
operations. 
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TERM 


Master Tape 


(MT) 


Monitor 


Octet 


Order Cards 


Order 
Programs 


Packed Mode 
(also "Form")} 


Parity Bit 


DEFINITION 


This tape contains all User and TOS or ETOS programs 
needed for operations during a specific working period 
(shift, day, week). The programs contained in this tape 
have been debugged and are arranged in proper sequence 
for carrying out the planned schedule of operations. 


Last segment of each program on MT or MD and used to 
load and start the next program to he executed. 


The basic unit of information in the GE 130 System, composed 
of eight binary digits (bits). 


Cards selected by the user for calling specific Order programs 


Programs called by Order cards for carrying out the Operating] 
Systems functions, such as; Initialization, Translation, 
Debugging. 


Generally denotes the packing of two decimal digits ina 
single octet. 


A check bit that indicates whether the total number of "1"' 
bits in a character or octet (including the parity bit) is 
odd or even. If the total number of "1" bits is always even, 
the system uses even parity; if odd, it uses odd parity. 
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TERM : DEFINITION 


A punched card containing program instructions. 


Program Card 


Program Code} See_"Program Identification Code". 


Alphanumeric program identifier (four characters in length) 
specified in a Program card, 


Program 
Wentification 
Code 


Program Type| See "Tape, Program". 


Half an octet. 


Quarter 


Record 


Group of characters normally treated as an entity by the 
program (Logical Record). One or more Records in a Block 
or Page. 


On tape, number of six-or eight-bit characters recorded 
in one inch longitudinally. Expressed in number of bits per 
inch, per track (bpi). 


Recording 
Density 


Reel See "Tape". 


The Arithmetic Control Unit, which is the internal 
processing instrument of the Central Processing Unit, can 
generate results of a qualitative nature. The Qualitative 
results generated during the execution of each instruction 
are recorded in the status indicators, two one-bit registers; 
Underflow/Overflow (UF/OF) and Zero/Non-Zero (ZE/NZ). 
The values of these indicators can be tested by the jump- 
instructions in order to introduce variants into the program. 


Status 
Indicators 

(UF/OF and 
ZE/NZ) 


Core Store area, used by the APS Assembler to assign store 
addresses during allocation of Core Store areas to data fields, 
constants, and instructions. 
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DEFINITION 


Supervisor The controlling of general functions, since it links the various 
phases of work, performs the physical Input/output operations, 
and processes the Order programs (this is part of the 
Operating System). 

Symbolic Name] See "File identification Code". 

of File 

System Dise Disc Pack used by DOS, DOS I or EDOS, containing the complete 

(SD) software system: Supervisor, Order programs and subroutine 
library. The SD also contains the user programs in the 
debugging phase. Generates, either directly or indirectly the 
LD and MD. 

System Area in Core Store reserved to the Operating System: For 


Reserved Area| additional information about different operating Systems 
Core Store location see page 40 of this manual. For specific 
content of those areas see appropriate manuals. 


System Tape Tape used by TOS or ETOS, containing the complete 
(st) software system and the user programs, if any, in the 
debugging phase (see System Disc). 


Tape Program Standard tape containing programs. May be a System Tape, 
Master Tape or Library Tape. 


Tape Mark Special one-character block on tape, detected by hardware. 
(tM) Used as program separator on program tapes and, more 
generally, on standard tapes, as the first and last block. 
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TERM DEFINITION 
Tape Operating Software provided for tape-oriented GE 115 System 
System (TOS) using magnetic tapes, it can process also data files 


on DS$130 dises. 


Tape Sequence Decimal number (four digits in length) specifying the 

Number sequential order of a tape (volume) in a file. Recorded 
in Tape Trailer Label and in File Header and Trailer 

‘ Labels. 

Tape Serial Alphanumeric tape identifier recorded in Tape Header 

Number (Volume Label (VOL1 or INT1). Six characters long. 

or Reel) 

Tape, Standard See "File, Standard". 

Tape Trailer An 80-character block of data indicating the end of a 

Label standard tape. Designated by name "EOV1". If contains 

(Volume or Reel) the quantity of blocks in the volume. 


(for Data Files) 


Tape Unit Controller identifier contained in Tape Unit 

Controller Name. Fixed value, depending on peripheral 

Name configuration. 

Tape Unit Name Used by PER or PERI Instruction to address a tape 
unit. Fixed one-octet value, depending on peripheral 
configuration. 
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DEFINITION 

Tape Unit Number assigned by the operator to a tape unit. 
Select Number 
Unpacked Mode Denotes the use of the right quartet only of an octet 
{also "Form") to store a decimal digit. it can also apply to binary 

numbers. 
VFU (Vertical The Vertical Format Unit, also called the VFU loop, 
Format Unit) is located under a cover on the right of the printer. 


The loop is an eight-track tape of metallized Mylar, 
with sprocked holes, between tracks 3 and 4, for 
driving the tape. 

Void Label See "Label, Void". 


Volume See "Tape" or "Disc Pack", 


Work Area Core Store area used for temporary storage of one 
record before and after processing. 


Work Dise Ancillary Dise Pack used Order programs. 
(wD) 


Work Tape Ancillary Tape used by Order programs. 
(wT) 
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B. PREREQUISITE AND RELATED READING 


P-A 
P-A 
R-A 
R-A 
R-A 
R-A 


R-A 


R-A 
P-A 


TYPE: 


Programming the GE-115 
GE-120 Reference Manual 
GE-130 Reference Manual 


GE-115 Dise Operating neal 
GE-115 Tape Operating System} 


DOs 0 


EDOS Programmer's Manual 
Vol. 1 


EDOS Programmer's Manual 
Vol, 2 


ETOS Programmer's Manual 


Data Files Organization 


P = Prerequisite Reading 

R = Related Reading 
A=Analysts Programmers 
O =Operators 


3916157F 
3917101H 
3918105 
3916163F 
3916162B 

To be 
39181170 


3918124R 


3918106B 
3916154T 


32.57. 003A 
$2, 20. 002A 
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CPBE-1800 
CPB-1824 


32, 20.003A 
32.38. 003A 
32,38, 005A, 


CPB-1896 
CPB-1181A 
CPB-1863A 


Assigned 


32.38, 010A | CPB-1826 
32.38. 011A 


CPB-1806 
CPB-1880A, 


32.38. 001A 
32.53.2024, 
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C, COMPATIBILITY BETWEEN APS LANGUAGES 


Many programs, written to be utilized by an Operating System, can be 
translated by a different Operating System with minus changes to the 
program. In the following chapters same changes which are to be made to 
a program, to make it compatible with the Operating System used, are 
described, 


1. ETOS environment 


Compatibility can be realized at two different levels: during the translation 
phase of a 115 source program or during the execution phase of a 115 object 
program. In the first case, the source program must be translated by the APS 
assembler. In the second case, the 115 object program simply has to be 
inserted in a 130 Master Tape. 


During the translation phase of a 115 source program by means of the APS 
assembler, the following must be kept in mind: 


e For program written in Extended APS: (*) 
a) - eliminate the PROG and DHP cards from the source program. The 
PROG card information is in fact contained in the e APS Order 


eard, while the DHP cards have no value for programs controlled 
by ETOS, due to the different file opening procedure. 


(*)-Not applicable in U.S.A. 
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b) 


e) 
dy 


e) 


g) 
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the FILE statements have the format and parameters different from 
one another as follows: 


EXTENDED APS APS ETOS 


1) uses two cards uses three cards 


2) the following parameters| 2) the EV Parameter is manda~ 


are not used: NS, OP/EP tory and the others are 
EV, OE, RM, PK, RP. optional 


the Block Area length for 
record type FL, must bea 
multiple of the record length. 


insert the OPEN macro-instructions for the magnetic tape files. 
the files must have standard organization. 


the STRT instruction must have an initial address not less than 
2400 or 2600, depending on whether a Hollerith or a Bull reader is 
connected to the system in which the program is to be executed. 
These two addresses must be 2560 and 2760 respectively, if the 
program executes card read and print or paper advance operations, 
using the xLBSS routine (which occupies the last 160 octets of the 
System Reserved Area). 


so that the object program can use the BIOS routines (includes in 
the 2400 or 2600 reserved area positions), all the magnetic tape 

file operations must be carried out by the OPEN, GET, PUT, NEXT 
and CLOSE macro-instructions and the card read and print 
operations must be executed by the xLBSS macro-instruction (see 

e, above). 

The macro~instruction GET, PUT and NEXT must be followed, in 
Extended APS, by a jump to the end-of-file routine. This jump, 
under ETOS environment, is generated by the assembler. 


for a program restart to occur, a CHKP macro-inst raction must 
be programmed. 
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e For programs written in Basic APS: 


Same as e) and f) (for read and print operations only). 


e For programs written in APS utilize in TOS: 


Same as e) above. 


Note that program instructions must not use absolute addresses, as 
operands, to reference the ETOS SRA (System Reserved Area). 


In order to translate a GE 115 source program using all 16, 384 store 
positions, it is necessary to make certain that the extension of the 
Operating System's reserved area does not render the store capacity 
insufficient (assuming that the program is translated and used in a 130 
system with a capacity of 16,384 positions). 


The APS assembler translates the 115 source program into a 130 object 
program and writes it on a work tape. The object program is then normally 
inserted in the System Tape by means of the e API Order card. 


The APS assembler is called by the e APS order card, which has the 
following format: 

columns1-4 identification code: » APS 

column 5 source program language 


- B, if the GE 115 source program is card-punched in 
APS-TOS or Basic APS 

- 1, if the GE 115 source program is card-punched in 
Extended APS (*) 

- 2, if the GE 115 APS-TOS source program is written 
on tape (WT1) 


column 6 type of source program 


- B, if it is a program 
- 1, if it is a subroutine 


*) Not applicable in U.S.A. 
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columns 7-14 -name of program or subroutine 

column 15 a listing of instructions is printed at the end of 
translation according to the optional content of this 
column: 


- or any character except x,the whole program is 
printed 
. 7, only the erroneous instructions with its relative 
error messages are printed 


columns 16 - 45 program description, which will be printed as the 
heading of the translated program's printout 

columns 46 - 72 not used 

columns 73 - 76 ID code, if required 

columns 77 - 80 not used, 


The operating procedures used for translation are those described on page 
287 of this manual. 


During @ program's execution phase, the supervisor can control both 130 
and 115 programs (written on the 130 System Master Tape) because of the 
possibility of using BIOS 130 or BIOS 115. 


115 programs are inserted on the 130 Master Tape by: 


I) creating a temporary 130 Library Tape from a 115 Library Tape 


II) setting up a new 130 Library Tape (with 115 and 130 programs) using 
the temporary 130 Library Tape and the already existing 130 Library 
Tape (with 130 programs only) 
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IM) setting up a 130 Master Tape from the new Library Tape. 


Programs from the 115 Library Tape are inserted on the 130 Master Tape 
by using appropriate order programs. 
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EDOS environment 


The compatibility of EDOS with the 115 programs means that a 115 source 
program can be translated into a 130 object program, under EDOS, 

The APS Assembler, under EDOS control, can also translate 115 programs 
written in Basic APS and APS (in DOS, TOS or DOS TI version), but the 
following conventions must be followed: 


e For Basic APS programs: 
a) The STRT must specify an initial address not less than 3960 or 
4160, depending on whether a Hollerith or Bull card reader is 


connected to the system where the program is to be processed. 


b) The card read and print operations must be executed by the 
xLBSS macro~instruction. 
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For APS programs in DOS, TOS or DOS Il, processing disc files: 


a) The STRT musi specify an initial address not less than 3800 or 
4000 (4800 or 5000 in tape/disc systems), depending on whether 
a Hollerith or Bull card reader is connected to the system where 
the program is to be processed. These addresses must be 
incremented by 160 positions, if the program executes card read, 
print or paper advance, operations using the xLBSS routine (which 
occupies the last 160 octets of the System Reserved Area). 


b) =©For an object program to use the BIOS routines (located in SRA), 
all operations on disc files must be commanded by ELOS I/O macro 
instructions and the card read and print operations must be 
commanded by the xLBSS macro-instruction. 


ce) When disc processing is called for by the program, owing to 
differences in storage medium between the GE 115 under DOS and 
TOS (DSS130) and the GE 130 (DSS161 or DSS110), the files that 
are processed in random or random-sequential mode, may use 
page lengths or a randomizing algorithm, which are no longer 
acceptable. 
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For APS programs in DOS, TOS or DOS Il, processing tape files: 


The same limitations apply as deseribed above in paragraph a. and 
paragraph b. (for card read and print operations only). 


For APS programs in ETOS (written for operation under ETOS ), see 
the first of the two conventions described in paragraph a. 


The APS assembly program disregards the PK and BF parameters of 
APS programs in DOS, TOS or DOS II FILE macro-instructions. 


Also note that program instructions must not use absolute addresses, 
as operands, to reference the EDOS SRA (System Reserved Area). 


The APS Assembly program translates 115 source programs or 130 


source programs (written for ETOS), into an.object programs which 
is used under EDOS, as described starting from page 292. 


361 


APS REFERENCE MANUAL 


DOS Il_ environment 


The APS assembler, under DOS II, can translate programs written in Basic 
APS but the following conventions must be followed: 


a) The STRT must specify an initial address not less than 2500 or 2700 
depending on whether a Hollerith or Bull card reader is connected to 
the system where the program is to be processed 


b) the card read end print operations must be executed by the xLBSS 
macro-instruction. 
It must be kept in mindthat program instructions must not be absolute 
addresses, as operands, to reference the DOS IT SRA (System 
Reserved Area). 


The APS Assembly program translates the source programs into an 


object program which is used under DOS II, as described starting from 
page 292. 
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DOS and TOS environment 


The APS assembler, under DOS or TOS, can translate programs written in 
Extended APS or Basic APS but the following conventions must be followed: 


For programs written in Extended APS: 


a) 


b) 


c) 


q) 


eliminate the PROG and DHP cards from the source program. 
The PROG card information is in fact contained in the e APS Order 


‘eard, while the DHP cards have no value for programs controlled 


by DOS or TOS, due to the different file apening procedure, 


The FILE statements have the format and parameters different 
from one another as follows: 


EXTENDED APS APS (DOS or TOS) 


1) uses two cards 1) uses three cards 


2) the following parame~ 
ters are not used: NS, 
OP/EP, EV, OE, RM, 
PK, RP. 


2) the EV parameter is manda~ 
tory and the others are 
optional 


3) the Block Area length, for 
record type FL, must be a 
multiple of the record length. 


insert the OPEN macro-instruction for the magnetic tape files. 


the files must have a standard organization 
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e) the STRT instruction must have an initial address not less than 
1600 or 1800, depending on whether a Hollerith or a Bull reader 
is connected to the system in which the program is to be executed 


f} so that the object program can use the BIOS routines (included in 
the 1600 or 1800 reserved area positions), all the magnetic tape 
file operations must be carried out by the OPEN, GET, PUT, 
NEXT and CLOSE macro-instructions and the card read and print 
operations must be executed by the xLBSS macro-instruction 

g) fora program restart to occur, CHKP and DCKP macro-instructions 
must be programmed. 


For programs written in Basic APS: 


same as e) and f) (for read and print operations only). 
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D, SUMMARY TABLES 


See overleaf the following tables: 


JUMP INSTRUCTIONS USED TO TEST QUALITATIVE RESULTS GENERATED 
BY OTHER OPERATIONS 


POSSIBLE CONFIGURATIONS OF PERIPHERAL UNIT NAMES 
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POSSIBLE CONFIGURATIONS OF PERIPHERAL UNIT NAMES 


PERIPHERAL UNIT NAMES 


BINARY VALUE HEXADECIMAL 


VALUES 
connector | peripheral unit 
identifier identifier 


i 

CONNECTOR 1 oo 10000 0 0 
‘ 

CONNECTOR 2 1 0 00 10000 8 0 


CONNECTOR 3 0 O lxx ixxxx (08 
: ¢ to 
H (3 F 
CONNECTOR 4 0 1 xx Ixxxx (4 0 
1 ¢ to 
(7 F 


NOTE: 


1, The names of peripheral units are represented by possible 
configurations of octet bits. The hexadecimal representation of these 
configurations will be the value to attribute to the first operand of the 
PER instruction. 


2, The two most significant bits of the octet identify the connector. The 
other six bits refer to the peripheral units. 


8, The 6-bit peripheral unit identifier relative to connectors 1 and 2 
contains a fixed configuration (00 0000). 
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4, The 6-bit peripheral unit identifier relative to connectors 3 and 4 
contains one of 64 possible configurations. 
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ORGANIZATION OF THE APS ASSEMBLY PROGRAM 


ETOS environment 


The APS assembler consists of 14 segments, each performing a specific 
function: 


Segment 1 


e interpret e APS card 
initial processing operations 
e@ check STRT instruction. 


Segment 2 


@ co-ordinate the various types of files for the execution of the FILE 
instructions. 


Segments 3, 4, 5 


® check for validity and execute the FILE instructions (setting up of file 
table). 


Segments 6, 7, 8 
e check for validity and translate the macro-instructions. 
Segment 9 


© compute lengths of subroutines to be assembled. 
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Segment 10 


Subroutine Library Index. 


Segment 11 
check for validity and translate or execute the instructions not using 
symbolic addresses, except for the FILE instructions. 

Segment 12 


check for validity and translate or execute the instructions using 
symbolic addresses, except for the FILE instructions. 


Segment 13 


assemble program, then print program listing. 


Segment 14 


assemble subroutines to main program. 
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EDOS environment 


The APS assembly program consists of 27 segments, each performing a 
specific function as follows: 


Segments 1 and 2 


e@ interpret the e APS, e SRC and e DSRC cards, 


Segments 3 to 10 


e initial processing operations 
e check STRT instruction 


@ co-ordinate the various types of files fr the execution of the FILE 
instructions 


e check for validity and execute the FILE's (setting up of file table). 


Segments 11 to 17 


@ co-ordinate the various types of macro-instructions 


e check for validity and translate the macro-instructions. 


Segment 18 


@ compute length of subroutines to be assembled. 
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Segments 19 to 22 


check for validity and translate or execute the instructions not using 
symbolic address, except for the FILE instructions 


check for validity and translate or execute the instructions using 

symbolic addresses, except for the FILE instructions. 
Segments 23 to 27 

translate program, the print program listing 


assemble subroutines to main program. 
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DOS Il environment 


The APS assembly program consists of 31 segments, each performing a 
specific function as follows: 

Segments 1 and 2 
e interpret the e APS, e SRC and e DSRC cards 


Segments 3 to 10 
® initial processing operations 
@ check STRT instruction 


@ co-ordinate the various types of files for the execution of the FILE 
instructions 


@ check for validity and execute the FILE's (setting up of file table). 


Segments 11 to 19 
@ co-ordinate the various types of macro-instructions 


e check for validity and translate the macro-instructions. 


Segment 20 


® compute length of subroutines to be assembled. 
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Segments 21 to 24 


check for validity and translate or execute the instructions not using 
symbolic address, except for the FILE instructions 


check for validity and translate or execute the instructions using 
symbolic addresses, except for the FILE instructions. 


Segments 25 to 31 


translate program, then print program listing 


assemble subroutines to main program, 
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oO 


Define Constant 

Define Peripheral Operation 
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INTRODUCTION 


This manual describes APS 130, the symbolic language of the CE 130 


Information Processing System, It ia divided into six parts, as 
followa: 


I. GENERAL DESCRIPTION ~ a description of APS language and its 
use. 


TI. FORMAT AND DETATLED DESCRIPTION - a description of the 
characteristics of APS 130, a detailed explanation of the 


symbols recognized by the system, its instructions, and when 
and how it is used. 


III.  INPUL/OUIPUD SYSTEMS - sets of subroutines controlling the 
information input/output. 


IV. EXAMPLE - of APS usage. 


V. OPERATING STANDARDS - a description of the general standard 
to be felisved when translating the source program and 
executing the object program, the messages and control 
signals printed by the assembler during program translation, 
and a list «=f tre HLT instructions that can occur during 
execution ef the cbject program. 


VI. APPENDICES - include information not homogeneous with that 
given in Parts I through V. The Glossary is in Appendix A. 


An index follows the appendices, 
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The first four parts are specifically addressed to programmers and 
applications specialists. Part V is primarily for operators. 


For the beat use of this manual, the reader should be familiar with the 
other GE 130 software described in the publications listed in Appendix B. 
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I. GENERAL DESCRIPTION 


Definition 


APS (Assembly Programming System) is a machine-oriented, 
one-to-one language which expresses in symbolic form all the 
primary instructions in the GE 130, thereby making full use 
of the machine's hardware. 


The use of APS rather than machine language facilitates 


program layout and reduces the possibility of error when 
writing instructions and fixing addresses. 


Organization 


The program written by the user in APS language is called 
the source program and consists of: 


= organization instructions 
= primary instructions 


- macro instructions, both aPS (arithmetic and controi) 
and input/output. 


The APS assembler is the program that translates the source 
program written by the user into the object program compiled 
in machine language. 
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The function of the APS assembler, therefore, is to generate 
an object program intelligible to the computer by reading the 
instructions that make up the source program and by reacting 
accordingly. 


Organization instructions are not translated into machine 
instructions but are used by the assembler to determine the 
organization of the object program. Primary instructions are 
translated directly into machine instructions by a one-to-one-form 
of translation. Some of the macro instructions are translated 
into a series of machine language instructions; some macro in- 
structions call subroutines that may or may not be part of the 
input/output systems and that will be assembled in the object 
program; others, concerning BIOS, are translated only into jump 
instructions to the BIOS routines (Basic Input/Output System) 
which are always present in store. 


In Figure 1, the translating functions of the APS assembler is 
described by means of a graph. The assembler, as organizer and 
translator of instructions and as assembler of subroutines 

(level 2, Figure 1} reads the instructions of the source program 
in APS language (level 1, Figure 1) and generates an object 
program (level 4, Figure 1) by assembling in the main program 

the required BIOS input/output subroutines and any other subrou- 
tines either written by the user or relative to the control of 
peripherals not controlled by BIOS subroutines (level 3, Figure 1). 


After the translation, the object program is ready to be 
processed (level 5, Figure 1), During program execution, 
physical processing of the files is carried out by the BIOS 
routines. 
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Figure 1 - APS MAJOR BLOCK DIAGRAM 
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The APS assembly program is written on the System Tape and is called 
by the .APS order card. (More detailed information about program 
tapes and order cards is given in the ETOS manual listed in Appendix 
B. The .APS card layout is given on page 192 of this manual. ) 


Segmentation 


Figure 1 does not show segmentation, which is a very important 

function of the APS program. The program can consist of a single 

segment, in which case it always resides completely in store, or it 

can consist of several segments, in which case a single segment can be 
called individually and overlaid totally or partially on the area already 
occupied by other segnents. 


When a required segment is to be inserted in store, it is called by means 
of the CALL macro instruction which restarts the program from an address 
specified in the CALL by the user. 


This address can be that of an instruction belonging to the segment in 
atore or to the same calling segment. 


A segment can call any other segment. The first segment ia stored and 
then started either by the .PRL order or by the monitor of another 
program. 


Each program segment in its turn can be divided into sections. All 
sections of a segment are stored simultaneously and, therefore, cannot 
be overlaid. 


The division of a segment into sections, however, makes it possible 

to codify two parts of the same segment by treating them, as far as 
using names is concerned, as two distinct programs. In other words, the 
same names can be used in two different sections and have different 
meanings. A name used in one section +o indicate a constant can be used 
in a subsequent one as the name of an instruction. This independence in 
the use of names that exiats between two sections is even greater 
between two segments. 
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When preparing a program to be divided into segments and 
sections, the following rules must be adhered to; 


a the program must begin with the STRT instruction 
and end with the END instruction. 


be. each segment must begin with: 


~ the STRT instruction, if it is the first in the 
program 


— any instruction, if it follows the first. 
each segment must end with: 


= the END instruction, if it is the last in the 
progran 


~ the ESGK instruction, if it is not the last in 
the program. 


Ce. the section must begin with: 

— the STRT instruction, if it is the first in the 
program, that is, the first section of the first 
segment 

- any instruction, if it follows the first section 
arid also if it belongs to segments following the 
first segment. 

the section mst end with: 

- the END instruction, if it is the last in the 
program, that is, the last section of the last 
segment 


— the ESGM instruction, if it is the last ina 
segment 


- the ESCT instraction, if it is within a segment, 
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It should be noted that even though a segment 
(except the: first in the program) can begin with 
any instruction, it must begin with the ORG 
instruction if it is to overlay, either wholly or in 
part, a preceting segment. 


Figure 2 illustrates the organization of a program consisting 
of two segments, the first of which is divided into three 
sections and the second into two. The chart shows the position 
occupied by each directive instruction. 


Segmentation offers particularly interesting possibilities 
for implementing certain acyclic program operations, such as 
file open and close, and reel change. 


Since file open and close operations, programmed with OPEN 
and OLOSE macro instructions, are normally carried out only 
once at the beginning and at the end of a program, they can 
easily be programmed in two distinct segments, one segment 
containing all the OPEN, the other all the CLOSE macro 
instructions. 


The operations that take place during normal program 
processing, such as reel change; require particular procedures 
for segmentation. A part must be found in the main 

program that is not subject to modification, such as a 
fixed-data table or a sequence of instructions not to be 
compiled..This part of the program must then be made into an 
independent segment. The resulting format of the program is 
as follows: 


segment A - contains the main part of the program 
segment B — contains the recoverable part 


segment C - contains the acyclic operation; for example, 
reel change. 


°° 


zs rF DOO R80 FD 


s 
SECTION 
E 
G 
M 
SECTION 
E 
N 
T 
SECTION 
8 
E 
SECTION 
ic} 
M 
E 
N 
Bi SECTION 


- 


REFERENCE MANUAL 


STRT 
INSTRUCTION 


Esct 
WISTRUCTION 
. 


ESscT 


INSTRUCTION 


ESGM 


(ORG) 
INSTRUCTION 


. 
ESCT 
INSTRUCTION 


Figure 2 - ORGANIZATION OF A SEGMENTED PROGRAM 


APS REFERENCE MANUAL 


When processing begins, segnent A calls segment B, thus 
starting the normal processing cycle. When executing the 
acyclic function, it calls segment C, which overlays segment B, 
and starts it. Segment C, after being executed, calls segment 
3 and restarts segment As 


B. USE OF APS 


1s 


2. 


Hardware Configuration 


The use of APS 130 requires the following minimum system 
configurations 


16K Core Store capacity 
- any reader that can be comected to the system 


- four magnetic tape units 


any printer that can be connected to the system. 


Software Environment 


The APS assembler can be used only with the Extended . 
Operating System. 
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TI. FORMAT AND DETAILED DESCRIPTION 


A. INFORMATION ABOUT APS LANGUAGE 


1. 


Language Characteristics 


wat the different language instructions, APS 130 can express 
all the instructions recognized by the computer, The 
advantages are the following: 


- the indication of the operations to be carried out by 
means of mnemonic codes (MVC to indicate a transfer, 
AB a binary addition, etc.) 


- the writing of the constants and other parameters of 
the program in the required form (binary, alphanumeric, 
hexadecimal) 


—- the using of symbolic names for the data fields and for 
the relationship between instructions without having to 
assign store positions. 


Forthermore, with specific macro instructions, APS 130 can 
generate entire sequences of instructions that give a rapid 
layout of the operations used most frequently, such as input 
and output or file opening and closing operations on tape, 
card reader, or printer. 


APS language is used in two distinct phases: 
ae the layout in ordered succession of the instructions 
that make up the development of a program. This is 
ealled the "soupoe program." >:+ 
b. the transformation of the source program into machine 


language, that is, language intelligible to the 
computer. This is called the “object program." 


v1 
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The obvious advantages of the APS 130 language are; 


increased programming speed 
reduced probability of error 
greater facility in the correction of errors 


ease in executing modifications. 


2. Instruction Types 


APS lan, 


8) 


b) 


°) 


guage instructions are divided into: 
organization instructions, which include: 


~ directive instructions, which are required by the 
assembler to control and translate the source 
program 


~ declarative instructions, which define the 
elements on which the program operates (data 
files, constants, store areas, etc.) 


- list control instructions, which determine the 
organization of the object program list 


primary instructions, which direct a genuine 
operation (transfer, jump, comparison, add, etc.) 
and correspond to normal machine language 
instructions 


APS macro instructions, including: 


-— control macro instructions, which cheok the 
execution of a program (for example, execution 
of a subroutine or giving program control to the 
Operating System) by interrupting sequential 
execution 
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- arithmetic macro instructions, which direct the 
four algebraic operations with the possibility of 
specific options 


input/output macro instructions, consisting of: 


- BIOS macro instructions, which execute physical 
input/output operations by using the BIOS routines 


- EI0S macro instructions, which execute the physical 
and logical operations on the input/output files 
by using the BIOS routines 


= input/output subroutine macro instructions, which 
execute the physical and logical operations on the 


input/output files by using the subroutines not 
included in EIOS. 


Organization instructions 


Organization instructions are reserved exclusively 
for the assembly program. 


The directive and declarative instructions supply 
all the data and information required by the assembly 
program in order to obtain a correct program in 
machine language. 

These instructions are used to indicate: 


- the start of the source program (directive) 


~- the length of the store areas occupied by the 
input/output data (declarative) 


~- the value and the length of constants that are 
useful to the source program (declarative) 


~ etc. 
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These instructions are not translated inte corresponding 
instructions in machine language but simply impose a 
certain organization on the assembly program. For example, 
an instruction with the symbolic code DS (area definition) 
reserves a store area the instruction DC (constant defini- 
tion) atores the constant expressed in the statement, etc. 


Prioary instructions 


Each primary instruction ie translated into the correspon- 
ding machine language instruction. 


Input/output and APS macro instructions 


The input/output and the APS macro instructions can, with 
a@ single expression, program those operations not 
directly executed by the computer which would otherwise 
require the layout of a series of machine instructions. 


The APS macro instructione are tranelated into a series 
of machine language instructions aesenbled in the main 
program or into a jump inetructions to a subroutine 
ineerted in the main progran. The input/output macro 
instructions are translated into jump instructions to 
subroutines that may or may not be included in BIOS and 
that are inserted in the main program or into a jump 
inetruction to one of the BIOS routines. 
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3. Symbols Recognized 


a 


Characters of the graphic set 


The GE 130 Information Processing System recognizes 
the standard 64-character graphic set, shown in 
Figure 3. Each number, letter, or symbol in this set 
has @ unique binary value represented internally by 
the eight binary digits of one octet. 

The internal representations of the graphic set are 
only @ part of the 256 possible binary configurations 
of octets. 


The octet is the smallest addressable unit in the 
GE 130 system and consists of eight bit positions 
representing the eight memory planes. 


The GE 130 assembly program accepts symbolic 
characters, decimal figures, or hexadecimal values 
for defining data. Binary representations cannot be 
used. If it is necessary to work with binary figures, 
the corresponding value mst be expressed in the 
program by one of the authorized representations. 


The symbols and characters that are reserved for 

the assembler, together with their specific functions, 
are described below. 

Reserved symbols 

The symbols of the graphic set that are reserved 

for the assembler and that cannot be used for 


defining field and instruction names are as 
follows: 


", OC) +-" 4 / 
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Binary Graphic Bi Graphic 
Contig. Hekeiootiat Contig. Hexadecimal 


01000000 
0001 
0010 
oor 
0100 
0101 
0110 
ont 
1000 
1001 
1010 
1011 
1100 
1101 
1110 


DPBrHOBN BH AON HAS 
"#1 DOTVTOZEZErAC 


ve 


Wit 


. 


01010000 


e®-Tanmoanaupyp 
In<xeBe<eCaqant 


GHABSSESSSEABSRLERS 
& 


ane 


Figure 3= The GE 100 Series Graphic Character Set 
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+ Apostrophe 


Two apostrophes are used to delimit the data 
fields, one to the right and one to the left 
of the data being specified. To express the 
apostrophe in C-type constants, two consecutive 
apostrophes mist be written. 


- Comma , 


The comma is used to separate operand 
specifications, when more than one operand 
is specified. 


- Parentheses ( ) 


Parentheses are used to contain length definition 
when this specification accompanies a field 
reference. They can also contain a reference 
address. 


- Arithmetic signs + - 


Arithmetic signs (+ or -} are used to modify a 
symbolic operand specification. The sign is 
followed by a decimal increment or decrement. 


- Asterisk * 
The asterisk is used in two ways. 


. An asterisk used for operand specifications 
indicates that the address of the specified 
‘operand refers to the left octet address 
of the instruction in which the asterisk 
appears. 


. An asterisk used as an operation indicates 
that the operand specifications field 
contains a comment to be printed during 
assembly. 
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Blank 3 


The blank indicates the end of the fields 
that make up the APS instruction (name, 
operating code, operands). 

One or more blanks can be written between 
the two apostrophes that delimit a C-type 
constant. 


- Slant / 


The slant sed in operand specifications 


for relabive addresses. It separates a 
relative adress (on the left) from the 
number of an index register (on the right). 


Field delimiter 


Operand specification separator 


() Length specification 

+ Increment specification 
- Decrement specification 
* 


As an operand specification: indicates 
store assignment 


As an operation: indicates a comment 


Indicates the end of the areas of an APS 
instruction 


Indicates address modification using 
index registers 


Pigure 4. Table of Reserved Symbols and their Uses 
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Alphabetic Symbols 


In addition to the above symbols, the APS 130 uses the 
following alphabetic symbols: 


AGKLRSDY 


The programmer can use these letters in the names of 
fields, constants, etc. The letter Y, however, must 
not be used as the initial letter of a field name, 
constant, or instruction because the names of system 
subroutines always begin with Y. Thus a new system 
subroutine could have the same name as that defined 
by the programmer imnhis program. 


~A 


The letter A is used in a constant definition 
instruction to indicate that the constant mst 
be stored internally in the form of an address. 


-6¢ 


The letter C in the operand specification field 
of an instruction indicates that the data item 
following C and contained between apostrophes is 
a character belonging to the graphic set (ise, 
0-9, A-Z, or a symbol). 

In an instruction defining a constant, ¢ indicates 
that the symbols of the graphic set are being used 
to define constant data. 


~X 


The letter X appearing in the operand specification 
field of an instruction indicates that the two 
alphanumeric characters enclosed by apostrophes 
are the hexadecimal symbols that define the 
operand character. In a constant definition 
instruction, X indicates that one or more pairs of 
hexadecimal digits are being used to define 
constant data. 
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“4 


The letter L precedes the length specification in 
instructions defining a field or a constant. 


-R 


An R in the operand specification field of an ORG 
instruction sets the value in the store assignment 
counter to the next higher multiple of 256. 

(No rounding off is done if the value is already a 
multiple of 256.) The store assignment counter is a 
part. of the assembler and is used for’ assigning 
addresses to instructions and data. 


-sD 


The letters S and D are used in the Line Feed (LF) 
instruction as line spacers. § requimes.stcaingbe, 
skip. D requires a double stip. 


-¥ 


In GE 130 system software, the letter Y is used as 
the first letter of the subroutine names. 


Control characters 


There are three special purpose control characters 

used by the Edit (ED?) instruction. They are represented 
in hexadecimal form as 20, 21, and 22. These three 
octets do not correspond to any of the characters in the 
graphic set and must be represented in assembly language 
instructions by pairs of hexadecimal digits. 
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B. HOW TO WRITE INSTRUCTIONS IN APS 


Use of the Programming Form 


Programs for the GE 130 Information Processing System are 
written in the GE 130 assembly language on the appropriate 
programming form (see Figure 5). 


Bach line in the form corresponds to a langvage instraction 
and is divided into the following areas: 


— PAGE NUMBER 

- PROGRAM IDENTIFICATION 

~ LINE NUMBER 

- NAME 

- OPERATION COLE 

~ OPERANDS. 

~ CONTINUATION 

- COMMENT 
Instructions are punched on cards. The instruction proper 
is punched from colwm 7 to column 72. The identification 
codes (page moumber, line number, ete.) are punched in the 
other columns. 
The end of each instruction is indicated by a biank. 
Character C in colum 72 indicates that the continuation of 


the instruction is punched on tha following card, starting with 
colamn 25. 


ai 
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I 
TH 
1 
FECECEEEEEEHEHHH 
j 100 
[ olsfr 
ooG 
UT ole |e 
oz jb 
[TT oft |e 
tt if olole 
ole |o 
0/8 | 0) 
ojzjo 
0}9}0) 
{ fafa 
I ooo 
{ olelo 
0}2] 0] 
: ooo 
che * 7 7 7 apie 7 
2 
Cawyusous wWiod ONIWHVEDONd Sav 
PUTT [ ave| sermneewe| sono ins “20 


wat ‘BOVE cinerea ions eit 
fl baad ouavolstnaar 99019223 GD wverng9 
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Figure 5 — APS Programming Form 
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Page number (colums 2-3) 


This indicates the progressive numbering of the pages 
in a progran. 


The page number is written at the top of each program 
form and is punched on all the cards of the same page. 


Both page and line number (see description of line 
number, below) must be in ascending order since they 
are used to sort all the cards in a program. 


It is, therefore, useful though not obligatory to give 
the page number a numeric value. 


Program identification (colums 73-80) 


This is the code that identifies the program and is 
common to all the cards of a given program. It can be 
completely or partially alphabetic and appears in the 
heading of the programming form. This area, however, is 
optional. 


Even if columns 77-80 are used, they are not considered 
by the assembler. 


Line number (columns 4-6) 
Line numbers are in ascending sequence Within a page. 


Line numbers are printed on the programming forms and 
are multiples of 10. This permits the insertion of other 
instructions when necessary. For this purpose there are 
unnumbered lines at the bottom of the form. Between lines 
040 and 050, for example, a maximum of nine lines can be 
inserted (041, 042, 043, etc.). Also, lines between 
instructions can be left free. 
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Name (colums 7-17) 
This is a group of alphabetic and numeric characters. 


One of the outstanding advantages of the APS language is 
the use of the name. When processing data and constants or 
when referring to instruction addresses, it is sufficient 
to express these data, constants, or addresses with a 
name for the APS assembler to assign each a position in 
store as Well as an address and a length. 


The name given to an instruction also serves to identify 
it within the program, thus permitting any reference 
whatsoever. If no reference is required, this area can be 
left blank. 


The name cannot have more than six characters and mst 
always begin in colum 7 with any letter but Y. It can be 
replaced by numbers or letters but not by special charac- 
ters or blanks (J's). 


The name must be defined only once in a section. Otherwise, 
an error signal is given. 


Columns 13-17 mist always be left blank. 
Operation code (colums 18-23) 


This identifies the type of operation being carried out 
by the instruction. 


It is a mnemonic code that can represent either a function 
code, in the case of primary instructions, or a generic 
rommand for the assembly program, such as a request to 
reserve areas, definition of constants, etc. 


There is a fixed symbolic code, always starting in 
column 18, for each instruction. This code has a 
maximum length of five characters and must be quoted in 
each instruction. 
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Operands (colums 25-71) 


An operand is the item of information processed (or 
operated upon) by an instruction. An instruction can 
specify different kinds of operands, 


Operands can be: 
- Data fields 


The data processed by an instruction can be 
located in a store area lying outside the 
positions occupied by the instruction or they can 
lie "within" the instruction. The latter type has 
been defined as "immediate" to distinguish it 
from data not contained in the instruction. 


— Instructions 


Instructions, or parts of them, can be the object 
of processing. In this case, their address or the 
address of one of their data items, appears in 

an instruction's operand area, For example, a 
program sequence can be interrupted by jumping to 
the address of an instruction. Also, an instruction 
can be either completely or partially substituted 
or modified. 


- Characteristic machine elements 


Names of peripheral units, status conditions of 
peripheral units, and UF/OF and 28/NZ indicators 
can be specified as operands, 


— Index registers 


Index registers can be specified as operands when 
they are used as data receiving fields, such as 
add fields in certain arithmetic operations, or 
as store areas for addresses that will be modified 
by other instructions. 
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The operands must be represented in the number and 
form appropriate to each instruction. 


The operands can vary in number according to the 
type of instruction. They are separated from each 
other by a comma. 


The operands area of all instructions, with the 
exception of DC and FILE instructions, must 
always be on a single card, that is, end with 
colum 71. 


Continuation (column: 72) 


When character C is punched in this area, it means that 
the instruction does not end on the card tut is continued 
on the following card, beginning with column 25. 


Comment 


The comment is punched in the operands area and at least 
one blank (f) character separates it from the information 
appropriate to this area. 


This area can be used to give each instruction.information 
that will be useful in the program's debugging phase. The 
comment is considered only by the assembly program since 
after translation it is ccupled with the corresponding 
machine language instructions in the printouts. 
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Operand Specifications 


APS 130 instructions can specify one, two, or no operands 
according to the type of operation tobe executed. 


The methods of specifying operands vary according to the 
type of operand and the type of operation. Operand 
specification begins in column 25. Each operand specification 
is separated from another by a comma. There can be no blanks 
between column 25 and the last column of the area containing 
the operand specification. If an instruction doea not require 
an operand specification, leave the operand specification 
field of the instruction blank. 


Methods of specifying operands are described below. 
ae Field symbolic addresses 
The operand can be indicated by a name (aymbolic address). 


In the course of the program, this name must appear in an 
instruction's name area. 


Example: 
sista se voces 
Sy errs ad ———— LTT) 
om ortnazon orenanor 


cone 


Ht Ht 


The instruction on line 010 transfers the content of the 
BETA field to the ALPHA field. The names (symbolic 
addresses) of these fields have been defined by declara— 
tive instructions. 


The instruction on line 040 is a jump instruction to 


the GAMMA field, which corresponds to the above MVC 
instruction. 
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This method of representing the operand is practical and 
offers ccngiderable advantages. In fact, when changing 
the data, addirg or cancelling instructions, the program 
works perfectly without direct intervention on the lengtha 
ard addresses. 


A’bsolute addresses 


Operands can also be defined by their absolute store 
addresses. For example, if the programmer wishes to 
place the value 2856 in the store address counter, he 
must write the following instruction: 


The store address must always be expressed by a decimal 
nunber with one to five figures. 


Note that an increment or decrement cannot be placed 
beside the Absolute address. 


It is, however, advisable to avoid using absolute 
addresses. 

It is better to use aymbolic names which, are easier to 
remember and which prevent errors if programs mut be 
modified. 
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oe Symbolic addresses with increments or decrements 


When an instruction refers to the name of a field, it . 
means that it operates from the first position of the 
identified field, that is, the leftmost or the 
rightmost according to the type of instruction. 


It is, however, possible to modify the initia] address 
of the operated field (right or left) by a certain» 
number of positions preceding or following the field's 
start position. 


If, that is, a programmer wishes to reference a 

position which has not been named, he can do so by 

using the name of a specified field. Beside it he 

writes the number of positions between the octet to 

be processed and the first octet of the field 

considered, prefixing this number with a + or — depending 
on whether the octet to be processed lies to the right 
(larger address) or to the left (smaller address) of the 
start of the reference field. 


For example, if ALPHA is the name of a data field of 
five octets and the programmer wishes to reference the 
third octet of ALPHA to compare it, using a Compare 
Menory to Immediate (CMI) inatruction, with the 
character $,he writes ALPHA + 2 in defining the operand. 


Similarly, if the programmer wishes to reference the 


octet to the left of ALPHA with the CMI instruction, 
he writes ALPHA - 1. 


—----————-_ 662 ALPHA + 


CHARACTER 


ALroh=? ALPHA + 2 


29 


APS REFERENCE MANUAL (*) 


The instructions referring to these operations are: 


Ante @ cuectaic pomimcarion 


eee Oi meena LL] 


com (eal ease ae Serene 
aoe peace 
= 


The increment or decrement aust be expressed by a number 

having from one to five figures. Avoid writing the 

non-significant zeroes. The symbols + and - are the only oO 
symbols accepted by the assembler to define the change. 


d. Relative addresses 


An instruction or a data field (which ig not an immediate 

operand) can be specified relative to the address 

contained in an index register modified by a specific o 
quantity (relative address). 


The quantity modifying the content of the index register 
can have a value ranging from O to 4095. If its value 

is 0, the operand address corresponds exactly to the 
contents of the index register. 


EXAMPLE: 


If the character $ is to be written in the first 
position of the ALPHA field, whose address has 
previously been loaded in index register 5, the proper 
coding, using a relative address~type operand, is as 
follows: 
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cexeane® iserals werinciee Pace ae BB 
od a eames 0000 
APS PROGRAMING FOR Goxaeks 

coe | mane oregayon orenanot : E 


OOGHNRNEEESSEACCTERRICG tH 


If the character is to be written in the tenth position 
of the ALPHA field, the instruction is: 


cxscens @ cere ee, Pane 


The modifying quantity in a relabive address. operand must 
alwaye be expressed..as a! decimal-number. 


Registers 6 and 7 are normally used by the GE 130 
system standard subroutines. 


ee. The asterisk 4 
The asterisk symbol (*) can be used as an operand. It 
always represents the function code address of the 
instruction in which it appears as operand. Like field 
names, it can be followed by an increment or a 
decrement. 


The use of the * as an operand is not recommended. 
Meaningful names are always easier to understand and 
remember, and errors can be avoided if programs mst 
be modified. 
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For example, if another instruction were to be inserted 
in the group of instructions following the LOOP 
instruction, the programmer would have to change the 
*=14 operand specification since the instruction named 
LOOP would no longer be 14 positions from the Jump 
Unconditional (JU) instruction. 


EXAMPLE: 


crass @ tere ‘orice nexnoee LL] 


ret H 


The instruction on line 050 should be written: 


enemy @ eutcraic veomrnearen See A | 
pe es 
orenanos A 
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f. Data fields and lengths 


4n operation which acts on variable length fields always 
requires a definition of the length of the field. 


Tf the length involved in the operation is that of the 
data field named, the length is implicit ih the operand 
and need not be specified. In all other cases where a 
variable length operation is to be performed, length is 
the number of octets used in the operation. 


The length is written as a decimal number enclosed in 
parentheses immediately to the right of the data field 
apecification. Its value must fall within the permitted 
range of operand lengths (from 1 to 5) for the particular 
operation the length of whose operands it defines. (It 

is not necessary to specify the non-significant zeroes. ) 


EXAMPLE: 


cenena @ teernie semana reenmoe LE 


GE- 100 sEMES 
APS PROGRAMING FORK 


Multiply the content of the operand with length 7, 
located at the address of BETA field-350, by a 
13-cetet operand located at the address contained in 
register 5 incremented by the quantity 3023.. 
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specified by an immediate character. The character is 
inserted in the complementary code during translation of 


the instruction. 


There are three ways of apscifying an immediate operand. 


It can be expressed as a graphic set character, a 
hexadecimal value, or a decimal number. 


In the first method, the specifiable characters are the 


64 of the graphic set, each one of which occupies a 
store position. 


In symbolic representation, the operand must be preceded 


by the character C and placed between apostrophes. 


EXAMPLE: 


cement @ eucre 


PROTA aER 


ar nson LL] 


onmrON 
oe 


Hit 


TH 


In the second method, the operand can be specified by 
one of the 256 possible configurations of the hexadecimal 
representation. In symbolic representation, the operand 


must be preceded by the character X placed between 
apostrophes. 


So 
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EXANPLE: 
eraenar @ cutcrate roomncaren 
pepe dedi 
Oe: tose TRA LOE 
sai inseam [rere eon ered = 
se | mane oregyron orenanos 
Oo ' F 
efzlo Pla 
ala ; 
ef efo iH 
oslo t cm I 


In the third method, the operand is represented by a 
numeric value between 0 and 255. Distinctive characters 
are not required in symbolic representation. 


EXAMPLE: 
aprrann @ cern: ‘eomecaren Peres) AF 
meeponagrars FASTIN SR SE ——$——— 
Sane tt n=... FOOT 
al uae onze yin “i 


Note that for all 64 characters of the "dense graphic 
set", any one of the three specification modes can be 
used to represent the required binary configuration on 
eight bits. 


EXAMPLE: 
cree alphanumeric form 
K'46" hexadecimal form 
70 decimal form 


will in each case be translated as 0100 OT10. 


Where the alphanumeric form is not possible, the 
hexadecimal or decimal form must be used. 
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EXAMPLE: 
X'8F' hexadecimal form 
143 decimal form 


will be translated as 1000 1171. 


For these and other forms of representation, the 
restrictions on the number of usable characters, the 
store positions occupied, etc. depend on the type of 
instruction and the way in which the instructions 


are used. 9 


he Indicator conditions 


In the conditional jump instructions (JC and JOR), the 
first operand is a value (condition) which permits 
. examination of the positioning of the un/or and Ze /NZ 
indicators. This test condition can be specified in two 
ways, as a hexadecimal or as a decimal number. The i+) 
methods of coding are similar to those for defining an 
immediate operand (see paragraph g, page 34). 


The Table of Conditions Generated by Primary Instructions 
in Appendix D indicates the correspondence between the 
qualitative results of the various GE 130 instructions 


(contained in the UF/OF and 28/NZ indicators) and the ) 
value (condition) assigned to the first operand of the 
JO and JOR instructions. ; oO 
EXAMPLE: 

GEMEsaL@ teecraie swemnearen tiga 


‘OF = 990 Somes 
APS PROGRAMMING FORK 


= emeocewe SINT TBIE| 
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A jump to address SIGMA is ordered if the result of 
operation AP is greater then or equal to zero (ALPHA@O). 


ie Index register names 


The instructions operating on the eight index registers 
of the Central Processor (Type 4 primary instructions, 

page 86) specify as first operand the name of an index 

register by means of a decimal figure ranging from 0 to 
Te 


EXAMPLE: the address of the data field named IOTA is 
loaded in index register 1. 


GeMeRa@ evectnic oenriica I 
Qeccrme een vscstbor ELS 


e-em PROCRN AE FaOcRaRER | BATE 
APS PROGRAMING FORE = 


ieRia 0. La 


je Peripheral unit names 


Instruction PER (Type 7 primary instructions, page 91) 
specifies as first operand the name of a peripheral 
unit. The value of this operand must be expressed in 
decimal Gr hexadecimal form. The methods of coding are 
similar to those for defining an immediate operand 
(page 34). 


In Appendix D, the names that can be specified for 


peripheral units are given in the Table of Possible 
Configurations of Peripheral Uhit. Names. 
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‘ ma wane LE] 


Execute the peripheral operation specified by the DELTA 
field on the peripheral unit named CO, (In this case, it 
is a printer with integrated controller linked to 
connector 1.) 


C. DESCRIPTION OF THE INSTRUCTIONS 


1. Organization Instructions 


Organization instructions are only used by the assembly program Oo 
to organize the translation of the object program. 


ae ‘ Directive instructions 


Directive instructions are not translated into 

instructions for the computer but contain some of the 

information required by the APS assembler for generating fe) 
the object program. 


They are used, for example, to fix the program's initial 
address and start address, to indicate the end of a 
section, segment, or program, or to fix the initial address 
of store areas or instructions. 
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The following directive instructions are described on 


pages 49-50: 


STRT 
ESCT 
ESGM 
END 
ENTRY 


ORG 
RORG 


Program Start 

End of Section 

End of Segment 

End of Program 

Declare Names Common to Several Sections and 
Segments 

Assign Origin Address 

Restart Origin Address 
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Program Start 


DYSCRIPLION: this instruction, always placed at the start of each program, 
supplies the APS assembler with the initial address of the 
program and the store size. 


INSTRUCT {OW FORMAT: 


WAME: not used 
OPERATION CODE: STRT 


OPERANDS: - OP. 1 start address of the translated program. This 
value cannot be less than 2400 if the system on which 
the program is to be executed has a Hollerith reader 
or less than 2600 if it has a BULL reader. If the 
translated program is a subroutine, the start address 
must be zero. 


- OP. 2 store capacity of the system on which the 
translated program is to be executed. It can have the 
-values 4, 6 and & (each number indicating a multiple 
of 4096 positions) 
-4 for store with 16,384 positions 
6 for store with 24,576 positions 


8 for store with 32,768 positions. 
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EXAMPLE: 


eenenar@ cect 


COMMENT: if the character indicated as second operand is other than 6 or 
8, it is considered as 4. 
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Eset 
End of Section 


DESCRIPTION: this instruction signals the end of a section. 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: ESCT re) 
OPERANDS: none 


EXAMPLE: 

sees —~_ == = @ 
use A vane Ler ; : orenanos F f i 

2 a aaa 
ae eo 
= Ee i =e 


COMMENT: each section must end with the ESCT instruction except for the 
last section of a segment, which endswith the ESGM instruction, 
and the last section of the program, which ends with the END 
instruction. 


a) 
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ESGM 
End cf Segment 


DESCRIPTION: this instruction signals the end of a segment. 


INSTRUCTION FORMAT: 
NAME: not used 
OPERATION CODE: ESGM 
OPERANDS: none 


EXAMPLE: 


cencnar @ euccrare ‘eomncaron 


GE- 100 SERIES a 
APS PROGRAWING FORM Sie eece 


ortaaton 
eo 


oneRanos 


SSONEgHSAUEVSATUNGREEETOREEELSRELESEEESEELUEELEGLE 
{ 
it 


T 


=e 
ict a Ise 
coon 
mf 


COMMENT: each segment must end with the ESGM instruction, except for 
the last segment of the program, which ends with the END 
instruction. 
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END 
End of Program 


DESCRIPTION: this instruction signala the end of the source program to 
the APS assembler and also gives the indication of the 
start address of the translated program. 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: END 


OPERANDS: the instruction consists of a single operand that 
indicates the start address of the translated program. 
The address can be indicated with: 
- a name, with adjustment if required 


- a decimal value. 


(Ok v00 sents 

APS PRocRuminG FORM 

une one: teen OPERANDS A 
a 2 y “ 8 
folale : 

ggg i 

ago U 

fe[s BREREI i I TO 


COMMENT: the start address mst be the address of a primary instruction 
belonging to the first segment of the program. 
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ENTRY 


Declare Names Common to Several Sections and Segments 


DESCRIPTION: in a program written in APS 130, the same names can be 
used in different segments and sections and have different 
meanings. For example, in the first section the name ALPHA 
can be used to define a constant while in a subsequent 
section it can be used as the name of an instruction. 


It might be useful to use the name ALPHA in the second 
section with the same meaning it had in the first section. 


In this case, the name ALPHA must be indicated to the 
assembler by the ENTRY instruction. 


The entry instruction, therefore, is used to signal all 
names used with the same meaning in several sections of 
one segment or in several segments. 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: ENTRY 
OPERANDS: OP.1, OP.2, ... 


ceeenene eee OPN 


The operands must be names with no adjustment. 


EXAMPLE: after having defined the constants ALPHA and BETA, it indicates 
that they are also used in other sections of the program. 
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Gentaa, @ crcerme 


a ee ee 
ero rf ; CECE EH 
BIT a HHH a 
th H 1 tH 
nee Ht HHH 


in an ENTRY instruction, as many names can be indicated 
successively until column 71 is filled. They cannot be continued 
on the following card. 


With a 16K etore, as many ENTRY instructions can be used until 
750 names are declared. The maximum number of names that can be 
used in @ program, including those declared in the ENTRY 
instructions, is 1100. 


In the ENTRY instructions, names of subroutines and names that 
appear in the FILE and ORG instructions are not declared because 
they are defined by the assembler. 
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ORG 


Assign Origin Address 


DESCRIPTION: this instruction modifies the value of the store assignment 
counter. The assignment counter is controlled by the APS 
assembler which, starting from the address indicated in 
the STRT instruction, gradually assigns an address to the 
various areas, constants, and instructions, thus updating 
the counter itself. 


INSTRUCTION FORNAT: 


NAME: not used 
OPERATION CODE: ORG 


OPERANDS: the instruction consists of a single operand that 
indicates the value to be substituted for the one 
contained in the address counter. 

When this operand has a value less than the minimum 
allowed by the Operating System, it prints the signal 
MN (see page196). It can be represented by: 


~ a symbolic name, with or without adjustment. 
In this case, the assignment counter has as its 
value the address corresponding to the name 
plus or minus any adjustment. 


The symbolic name is inserted by the APS 
assembler in the table generated by the ENTRY 
instruction. 


- a decimal value. In this case, the assignment 
counter assumes the value indicated. 
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EXAMPLE: 


Gemenar @ crecrare 


GE 100 semes 
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- the character * followed by an adjustment. 


The character * represents the current value of 
the counter. In this way, the counter can be 
adjusted backwards or forwards. 


- the character R. In this case, the current value 
of the assignment counter is rounded to the 
nearest multiple of 256. If the assignment 
counter's value is already a multiple of 256, the 
instructicn has no effect. 


~ the character R with an adjustment. In this case, 
the 256 miltiple address less than or equal to the 
current address of the assignment counter is 
considered and the adjustment is made. 


The address thus obtained ig taken as the new 
origin if it is greater than or equal to the 
current address; if not, the 256 mltiple address 
greater than the ourrent address. is considered 
and adjustment is made. 


orenanos ; 
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The first ORG instruction orders the increment of the assignment 
counter by 50 positions, thus leaving a free area. The second ORG 
instruction sets the counter back by 80 positions, that isrto the 
ALPHA instruction. 


The following DS defines an area with length 10 and with an initial 
address corresponding to the ALPHA instruction. 
EXAMPLE 


sewena@ euecraic sooeincanon 


ae et 


Hf 


Assuming that the assignment. counter of the ORG instruction has a . 
decimal value of 2560, after the ORG instruction it will have 
a @ecimal value of 2624. 


Assuming, however, that the assignment counter has a decimal value 
of 2630 before the ORG instruction, after the ORG instruction it 
will have a decimal value of 2880. 
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RORG 
Restart Origin Address 


DESCRIPTION: this instruction interrupts the consecutive assignment of 
addresses. It substitutes the current value of the address 
counter with the value it had before the execution of the 
last ORG instruction encountered in the course of the 
program. oO 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: RORG ° 
OPERANDS: none 


EXAMPLE: i 
anit ine pe Se, ot (@] 


OPERATION OPERANDS | 
poppe Me 4 at ot 
alee ig BCH : ct 
agg TAT oo U i I 


White the ORG instruction sets the counter back by 6 positions for 
the definition of a BETA field, the subsequent RORG instruction 
repositions the counter to the maximum value it had reached 
previously, that is, before examining the ORG instruction. 
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Declarative instructions 


Declarative instructions are used by the programmer to 
define the elements on which the program operates. They 
define the format and type of file processing (on cards, 
printer or tape), the store areas, the constants that are 
operated during processing, and the characteristics of 
the external operation commands. 


Declarative instructions are not, therefore, translated 
into machine instructions. With these instructions, the 
APS assembler stores parameters or constant data or 
simply reserves areas for the programmer's use. 


The following declarative instructions are described on 
pages 52-75. 


DS Define Store 
pe Define Constant 
DP Define Peripheral 


FILE Define File (defines a card file, a print 
file, or a magnetic tape file). 


NOTE: the maximum number of files that can be defined in 
a program is 22. No more than one card or print 
file can be defined. The definition of a magnetic 
tape file, if it exists, must always precede any 

- definition of a card or print file. 


A description of the organization of card, print, 
and magnetic tape files will be found in 
Appendix BE. 


The FILE instructions must immediately follow the 


STRT instruction, but list control instructions 
can be intermixed. 
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DS 


Define Store 


DESCRIPTION: reserves one or more store areas and assigns a symbolic 
name to the first one. 


INSTRUCTION FORMAT: 


NAME: any name that has as its value the area address and as its 
length the length of the first area. 


OPERATION CODE: DS 


OPERANDS: the instruction consists of a single operand with the 
following structure: 


dLn 
where: 
-a is the duplication factor indicating how 
many times the store area is to be repeated. 
Tf the duplication factor is 
4 it can be omitted 
O an address is given to the name of 
the area without actually reserving 
it 
The maximum value for the duplication factor 
is 256. 
~.L is a separator 
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-n is the actual length in characters of the 
defined area. The length must always be 
present and must have a value ranging from 
1 to 256. 


COMMENT: if the duplication factor is set equal to zero, the length and 
address are given to the name appearing in the "name area." The 
assignment counter, however, is not set forward. in this way 
sub-areas can be defined within an area. 


EXAMPLE: 


Genenat @ erectare ‘wewrinicar 
SE cuss rcs sara 


owes a ae 
ees ee» LOTT) 


cme | mane oneggyen 


OPeRanos - 


i 
i Dit I TTT 


The area named CARD can be repeated three times by 

reserving 45 x 3 positions. The value given to the name CARD 
is the address of the first reserved area and the length is 
45. The area named READ, however, consists of 200 characters. 
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EXAMPLE: 


seuta@® tuceratg fommrincarion Jesiacoes AB 


re ETT 


OreRanos 


(Ge. 100 semes 
APS PROGRAMMING FORL 


Only the DATE and VALUE areas are reserved in store and are, 
in effect, sub-areas of CARD. The advantage is that when the 
two areas are called simltaneously, it is necessary to refer 
only to the name CARD. In fact, even though the area is not 
reserved in store, the name is given a length and an address. 


The addresses of the DATE and VALUE areas are not relative to 
the initial address of CARD but are the actual addresses. 
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DC 


Define Constant 


DESCRIPTION: stores any kind of constant. 


INSTRUCTION FORMAT: 


NAME: any name that has as its value the address of the area that 
contains the constant and as its length the length of the 
constant. 


OPERATION CODE: DC 


OPERANDS; the instruction consists of a single operand corresponding 
to the constant that is to be defined. The operand is made 
up of four elements with no blanks between them. These 
are: 


~ Duplication factor: it establishes how many times the 
constant specified in the operand is to be generated. 
It must be a decimal number ranging from 1 to 256. When 
it equals one it can be omitted. 


- Type of constant: by means of an alphabetic character 
it indicates the form in which the constant is to be 
stored and considered. 


Possible typos of constants are: 


- € alphanumeric form (one store position for 
each character expressed) 


- X hexadecimal form (one store position for 
two characters expressed) 
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-A binary form (from 1 to 4 store positions for 
each constant). 


= Length of constant: it is expressed by a decimal number, 
preceded by the letter L. Maximum length depends on the 
type of constant. 

- Constant: it must be placed between apostrophes for 
types ¢ and X and in parentheses for type A. 
The length of the assigned store area for each 
constant is given bys 

a.L 

where: 


-d is the duplication factor 


-L is the length of constant. 


EXAMPLE: 


seven @ wscras sence rernaon i] 


——— =. EO 


orenanos 
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COMMENT: if the constant expressed as operand has a length that cannot be 
contained on a card, it can be contimed on several lines of the 
form, each line ending with an apostrophe (in any column) and 
with character C in column 72 (except the last line). ‘The 
succeeding lines start with an apostrophe in column 25. 


The symbolic code DC mst be indicated only on the first line. 


Note that the name of the constant has as' its length that 
expressed in the instruction independently of the duplication 
factor. For example, the constant 5 CL1'0' occupies five store 
positions while the name associated with it has a length equal 
to one, 


Types of constants 
~ Type C constant: alphanumeric form 


Use: with the type C constant all the.characters belonging 
to the graphic set can be expressed and then stored in 
memory. Each occupies a estore position. 


If the apostrophe is to be in the constant, it must be 
repeated twice. 


Length: the length must never exceed 256 characters. There 
is an error signal if it does or when the number of 
characters between apostrophes is greater than the 
declared length. 


If, on the other hand, the length is greater than the 
mumber of characters actually appearing in the 
constant, enough blanke (¥) are placed in store, to 
the right of the constant, until the specified length 
is reached. 


ume | ame 
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cite, « MOTT 


ie eae ary iri, 


oppeaton A] 
oe oreranos B 


da aaa 


constant CST 1 is stored in the memory 


ROME $B ROME ys 


constant CST 2, however, signals error I (operand 
incorrect). 


- Type X constant: hexadecimal form 


Use: each character specified in the constant is written on 


half a store position. 


All 256 configurations of the GE 130 internal code can 
ve written in hexadecimal form (See paragraph 3.a, page 


15.) 


Length: indicates the number of positions occupied by the 


constant (one position for every two characters 
expressed) and must never exceed 256. If it does, an 
error signal (I) is given. The same type of error 
eccurs when the number of characters expressed in the 
constant is odd or more than twice the length 
indicated. If the number of characters expressed in the 
constant is less than twice the indicated length, the 
constant in store is columned to the right (right 
justified) and the area to its left is completed with 
binary zeroes. 
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eaneane @ tuccrae seomnesnen AB 

Soh earn ee vee 
Se ve renee LOTT) 
lhe aauv: ; 
ong : 

fo] 2/0 QE | 

ate 


= 
i 


[ 


the instruction RED is translated: 
0000 0000 0111 1100 1000 1010 
o 0 7 ¢ 8 A 


—— —— a 
poss n pos.n+1 pos ente 


the instruction BLACK is translated: 


0000 0000 0001 1011 


i) Qo 41 3 
| —— 


pose n posentt 


the instruction GREEN,on the other hand, gives the error 
signal I (operand incorrect). 


- Type A constant: addrese form 


Use: addresses written in store in binary form can be 
expressed with this type of constant. 
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Length: the length expressed must not exceed 4. 


If the length indicated ia 4, the resulting constant 
includes the length expressed on two positions as well 
as the address. This type of instruction can be used 
only if the operand is expressed by a symbolic name. 


If the length indicated is 3, the resulting constant 
contains the length as Well as the address. This type 
of instruction can be used only if the operand is 
expressed by a symbolic name. If the length expressed 
is 1 or 2, the operand is always translated in binary 
on two positions. In store, however, if the length is 
1, only the less significant position, that is, the 
rightris written, 


EXAMPLE: 
GenEMAL @ eueeraic 
Piya Sa oe 
nbs (rs 
ume | ase Orenanos i, ; 
mn . ‘i i ste % qi 
lz Susie: { 
nogaciel HH 4 HTH H 
sleet. 
ee TT FREE LECH aa 


= the constant HOUSE has a value 1; in binary, 257 occupies 
9 bits, that is: 


100000001 
Since the length indicated is 1, equal to & bits, the left 
position is lost and the constant is written in the memory 


ast 


00000007 
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- the constant ROAD is translated on thrce positions, the 
first of which contains the length while the other two contain, 
in binary, the left address of area SK 


- theoonstant CST 1 is translated on two positions as the 
address of SK + 5 


= the constant CST 2, however, signals error I (operand 


incorrect) since it is not possible to indicate the address 
with the symbol * for this type of constant. 
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DP 


Define Peripheral Operation 


DESCRIPTION; this instruction is used to generate in store an external 
command with a length of 2 or 6 octets. It is not usually used by 
the programmer but by the input/output subroutines supplied 


by the software. 


INSTRUCTION FoORHAT: 


NAME: any name that has the address of the constant as its value 
and the length of the constant as ite,length. 


OPERATION CODE: DP 
OPERANDS: two or three that have one of the following configurations: 
2,X 
Z, X, I 
2, X, I (n) 
where: 
~ Zand X are the parameters defining the external 


command. Bach can be expressed in 
hexadecimal or decimal form, as follows: 


hexadecimal (e.g., X'80') 


decimal (e.g-, 128) 
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-I1 indicates the address of the first store 
position involved in the transfer. It 
can be expressed with: 


- a symbolic name, possibly followed by 
an adjustment. In this case, the name 
is given a value equal to the left 
address of the instruction with which 
the name is associated 


— @ decimal value 


~ the character * followed by an 
adjustment. 


-n indicates the transfer length. 


If the address is expressed with a 
symbolic name, the length can be omitteds 
in which case it is made to equal the 
length of the memory area with which the 
symbolic name is associated. 


EXAMPLE: 
at @eecraic 
oe see er 
APS PROGRAMING FOR - 
wwe | name orensrow orenswos F 
: TT 
lo 7 U 


URNA 


cove fea tare acre 
nnd 
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FILE 
Define Card File 


DESCRIPTION: this instruction specifies all the information required 
for processing a frls, This information is needed by the 
assenbly program to set up the files table. 


FILE occupies two cards. Character 3 must be punched in 
column 72 of the first card to indicate that the instruction 
continues on the next card. 


INSTRUCTION FORMAT: 
FIRST CARD 


NAME: not used 
OPERATION CODE: FILE 
OPERANDS: - OP. 1 


Symbolic name by means of which reference ie made 
within the program to the file being processed. 


- OP, 2 DV = CR 


This operand indicates that the peripheral unit 
used by the file 1s the card reader. 


- OP, 3 BV = (address) 


Thie parameter represents the address, expressed 
with a decimal value or a symbolic name, of the 
program sequence (prepared by the user) to be 
executed at end-of-file (reading a card with the 
first four characters equal to END or with hopper 
empty and the EOF switch on). 
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SECOND CARD 


NAME: not used. 
OPERATION CODE: not used 
OPERANDS: - OP. 1 BA = (address) 


This parameter represents the store area address 
for the card read. It can be specified by a 
symbolic name, a decimal address, or the name of an 
index register. 

(Note: registers 6 and 7 cannot be used.) 


~ OP. 2 BK = (length) 


It represents the length of the previous area 
expressed by a decimal number with a value not 
greater than 80. 


EXAMPLE: 
emenar @ euecrac ‘eorisicaceal sonal 
tn root ee er ere 
7% Procesmane rom eee ee 
ears i Fy 
uve | pase onenaTON orenanos ; 


Le eee 
SANEIHEZ EGE: SAHEEEL 1H SSIS 


The instruction defines a card file called ENTER. FIFL is the 
instruction that starts the processing sequence for end-of-file. 
CARD is the symbolic name with which the address of the card's read 
area is associated. The area length is 80 positions. 
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PLLE 


Define Print Tile 


DISCRIPHION; this instruction specifies all the information needed for 
processing a file. This information is needed by the 
assembler to sot up the files table. 


FILE consists of two cards. Charaster ¢ inmust be punched 
in. column 72 of the first card to indicate that the 
instruction continues on the subsequent one. 


INSTRUCTION FORMAT: 
PIRS? CARD 
NAMF: not used 
OPPRATION CODE: FILE 


OPERANDS: = OP. 1 


Symbolic name by which reference is made within the 
program to the file being processed. 


- OP. 2 D= PR 


This operand indicutes that the peripheral unit 
used by the file is the printer. 


~ OP. 3° FL or VL 


This operand indicates that the output records are 
of fixed or variable length (FL or VL). 
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- OP. 4 EV = (address) 


This parameter represents the address, expressed by 
a decimal value or a symbolic name, of the program 


sequence (prepared by the user) to be exccuted at 
end-of—form. 


- OP. 5 OE = (address) 


Phis represents the address, expressed by a decimal 
number or a symbolic name, of the program sequence 
(prepared by the user) to be executed if there is a 
print error or an out-of-service signal. 


This operand is optional. 


SECOND CARD 


NAME: not used 
OPERATION CODE: not used 
OPERANIG: - OP. 1 BA = (address) 


This parameter represents the address of the store 
area that contains the record to be printed. It can 
be expressed by a symbolic name, a decimal address,’ 
or the name of an index register.(Note: registers 

6 and 7 cannot be used.) 


- OP. 2 BK = (length) 


Represents the length of the preceding area, 
expressed by a decimal number with a value not 
greater than 162 for fixed-length records, or 163 
for variable-length records. 
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EXAMPLE: 


eenemat @ erecraic. wommcarion 


(Oe. yoo genes, 
APS PROGRAMMING FORK 


aa Oremanos 


ee a 


H 


The instruction defines a print file callef EXtT consisting of 
records of variable length. At end-of-form, the program sequence 
with name FIMO must be executed, No r-utine is provided in the 
event of a print error or an out-of-service signal. The address of 
the record to be printed is contained in register 3. The maximum 
length of the record is 136 positions. The parameter BK must have 
the value of 139; this in the length of the BA area, which includes 
three service characters plus 136 characters to be printed. (See 
"Print Files” in Appendix EB, pag. 231). 
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PILE 


Define Tape File 


DESCRIPTION: this instruction contains the parameters relative to all 
the tape files, both input and output. These parameters are 
needed by the assembler to set up the files table. Each 
instruction consists of three cards. 


INSTRUCTION FORMAT: 
FIRST CARD 


NAME: not used 
OPERATION CODE: FILE 
OPERANDS: — OP. 1 
Symbolic name for reference within the program to 
the file being processed. 
- OP. 2MP=aN 


The parameter N is a decimal number ranging from 1 
to &. It indicates the external name of the unit 
used. 


-— OP. J} AT =N 


The parameter WN is expressed like operand 2. It 
indicates the tape unit to be used, as an 
alternative to the previous one, for a file on 
several reels. 


This operand is not used if the file is on a single 
reel or if it does not have to be alternated with 
another unit. 
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~ OP. 4 


This parameter indicates the structure of the 
records in the file. It can have one of the follow- 
ing values: 


FL the file is made up of fixod-length 
racords 


VL the file is made up of variable-length 
records 


UN the file is made up of Yecord blocltea, 
i.e., each block consists of a record. (e, 


- OP. 5 NI 


Key word indicating that tho bloc’ca are not 
numbered, The file miintaing the standard 
organization. 


~ OP. 6 NS = (address) oO 


Thia operand indicates that the file is organized 
in non-standard mode. File opening and closing are 
executed by the program sequence whose address 

ig specified in this operand. The address can be 
expressed in decimal form or with a symbolic 


name. The program sequence must be prepared by the 
ubere i *) 
- OF. 7 DV =f °o 


This operand indicates the type of controller for 
the tape units used 


Mt for standard controller. 
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This operand indicates that the check of each 


file character must be executed in: 


— parity if HP 
- disparity if OP 


The disparity check is required if this operand 


is not used, 


Charcter C must be indicated in card column 72. In fact, information 


relative to the file continues on the second card. 


SECOND CARD 


NAME: not used 
OPERATION CODE: not ueed 
OPERANDS: —- OP. 1 BA = (address) 


Represents the store area (block area) reserved for 


the physical element (block). The address can be 
expressed by a symbolic name or a decimal value. 


OP. 1 BK = (length) 


Represents the length of the previous area (BA). 
Thie length is expressed by a decimal number not 
lees than 80. 


OP, 3 WA = (address) 


Represents the area (work area) reserved for the 
logical element (record). The address is 
expressed by a symbolic name, a decimal value or 
the name of an index register. (Note: registers 
6 and 7 cannot be ueed). 
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~ OP. 4 RC = (length) 


Represents tne length, expressed by a decimal 
number, of the previous area (WA). 


For files with a block number, the value of the 
operand RC must be greater than or equal to 15. 


For files with no block number, the length mst be 
greater than or equal to 20. 


For variable-length records; the maximum length is 
1,023 characters. 


For files organized with fixed-length records 
(FL type), the parameter RC must be a submuitiple 
of the parameter BK. 


This operand and the preceding one are not used 
if there is physical processing, that is, in the 
case of a file consisting of single-record blocks. 


Character C mst be indicated in column 72 since the information 
continues on the following card. 


THIRD CARD 


NAME: not used 
OPERATION CODE: not used 
OPERANDS: - OP. 1 EV = (address) 


Represents the address, expressed by a decimal 
value or a symbolic name, of: the program sequence 
(prepared by the user) to be executed in the event 
of end-of-file, end-of-volume, or end-of-tape. 

This routine must execute only the specific 
functions of the program and not the generic closing 
operations carried out by the CLOSE instruction. 
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Re-entry to the main program depends on the routine 
itself. This operand is mandatory. 


OP. 2 OF = (address) 


Represents the address, expressed by a decimal. 
number or a symbolic name, of the program sequence 
(prepared by the user) to be executed if there is 
systematio error in file processing. This operand 
is optional. If it is not used the systematic error 
causes the program to halt on one of the tape-error 
standard HLT's. 


6 
oP. 3 RM = 8 
This operand indicates the type of magnetic tape used. 
The 6 refers to 7 (6+1)-track tapes and the 8 to 9 
(8+1)-track tapes. If this operand is not used, it is 
assumed that the tape has 7 tracks. 


Op. 4 PK = 


VOVN 


This operand indicates the registration density, that 
is: 


200 characters per inch 
556 co) ” 
800 " " " 
= 1600 " “ “ 


W 


voun 
a 


This operand is optional. If it is not used it is: 
assumed that 7-track tapes have a density of 556 
characters per inch and that 9-track tapes have a 
density of 800 characters per inch. 


13 


APS REFERENCE MANUAL Oo 


- OP. 5 RP = (nnn) 


non indicates the file's retention period, ranging 
from 0 to 999. This operand ia optional; if it ie 
not presert it is considered as 0. 


The instruction defines a file, ENTER, mounted on unit 2. *) 
The file is on 4 single reel and is composed of fixed -length records. The 
controller is standard and the parity check is required. 

The blocks consist of 505 charactera divided into five recorda 

each 100 characters in length. FIFL starts the end-of-file or 

end-of-volume processing sequence. There ia no routine for error 

checks. The tape used is 7-track with a registration density of 

556 characters per inch. File retention is not required. r*) 


NOTE: the information supplied by the FILE instruction is used to form 
the files table. 


This table containg all the information needed by the EIOS syatem 
for file processing and is assembled at the beginning of the first 
segment of the program. 
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The programmer mast take: care whan using the ORG instruction to 
prevent the files table from being overlaid by the subsequent 


segments sinceit must always be present in store for the operations 
executed. | 
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List control instructions 


These instructions contain orders concerning the 
organization of the object program lists. 


They are: 
es Comment 
EJEC Jump to Next Page 


LF Line Feed 
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* 


Comment 


DESCRIPTION: this instruction has no effect during program translation 
but simply determines,during the list phase of the 
translated program, the printing of the charactera written 
in the operand area. 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: * 


OPERANDS; the instruction consists of a single operand made up of 
a series of characters that can be used as a comment or as 
a heading for a given part of the program.. 


EXAMPLE: 


© atten @ ccc | ae Paar e Bet eeee 5B 


ovens 


Foon] 
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EJEC 
Jump to Next Page 


DESCRIPTION: the instruction has no effect during program translation. 
During the list phase of the translated program it causes a 
skip to a new sheet before the next instruction is printed. 
This instruction can be used to demonstrate a given part 
of the object program. 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: BJEC 
OPERANDS: none 


BXANPLE: 
ene. @ secre omen vaaneee LE] 


Papaya PROCRDANIRE "FRocR ER] xt} << AURORA 
[APS PROGRAMING FORK | rari. 


Openanos: 
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LF 


Line Feed 


TESCRIPTION: this instruction has no effect during program translation. 
During the list phase of the translated program it executes 


one or two line feeds ora paper skip before the next 
instruction. 


INSTRUCTION FORMAT: 


NAME: not used 
OPERATION CODE: LF 
OPERANDS: the instruction consists of a single operand that can have 
the following values: 
5 single line feed 
D double line feed 
sf skip controlled by track 1 of VFU 
2 skip controlled by track 2 of VFU 


T skip controlled by track 7 of VFU 
EXAMPLE: 


iniok @ teitit pears ofa] 


aim fa Maal Sa es 


2] 
uve | mat onenation orenanos ; 
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Primary instructions 


Primary instructions have a one-to-one correspondence with 
machine language instructions. 


They are writtemt as symbolic expressions. The GE 130 assembly 


. program generates an instruction in machine language for each 


primary instruction. 


Primary instructions:are written according to the rules desoribed 
in the G& 130 Reference Manual. 


Primary instructions can be classified according to two 
criteria: their format in store after translation or their 
format in APS language. 


A description of the primary instructions classified according 
to their internal format is given on pages 81-92. A list of 
the instructions grouped according to their APS language format 
is given on page $3. 


a. ‘Type 


1 Instructions 
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The GE 130 instruction repertoire consists of fourteen 


Type 


Type 


7 instructions: 


Add Decimal 

Add Packed 
Subtract Decimal 
Subtract Packed 
Move Right Quartets 
Move Packed 
Compare Right Quartets 
Compare Packed 
Multiply Packed 
Divide Packed 

Add Binary 
Subtract Binary 
Pack with Sign 
Unpack with Sign 


UPKS 


1 instructions consist of: 


an operation code 


— an operation complement containing length information 
for each of two operands 


- address references to the rightmost octets of the 


two operands 


The operand length information is obtained either directly 
from the instruction coding (when length specifications 
are entered by the programmer) or from the actual length of 
the data field specified by the operand. 
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After translation into machine language, each Type 1 
instruction occupies six octets of store, as follows: 


oan] 


octets. | i | A | F ‘ 


Operation Code 
Operand 1 Operand 2 
Operation Complement Address Address 
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b. Type 2 Instructions 


There are eleven Type 2 instructions in the GE 130 
instruction repertoire: 


Hove Complete Octet YC 
Compare Complete Octets Chic 
"And" on Complete Octets NC 
“Or” on Complete Octets oc 
Exelusive "Or" on Complete Octets XC 
Search to the Right SR 
Search to the Left SL 
Edit EDT 
Translate TR 
Pack Right Quartets into Octets PK 


Unpack Octets into Right Quartets UPK 


Type 2 instructions consist of: 
- an operation code 


- an operation complement containing length 
information for the first of the two operands (*) 


- address references to the leftmost octets of the 
two operands (**) 


alg with Type 1 instructions, the length information is 
obtained directly from the instruction coding or’from the 
length implicit in the data referenced by the first 
operand (*) depending on whether or not the length has 
been specified by the programmer. 


(*) The second operand, in the UPK instruction. 


(**)In the SL instruction, the first operand address reference is to 
the rightmost octet. 
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After translation into machine language, each Type 2 
instruction occupies six octets of store, as follows: 


ois] ae nae baikanes 


6 octets 


Operation Code ] 
Operand 1 Operand 2 
Operation Complement Address Address 


ce. Type 3 Instructions 


There are six Type 3 instructions: 


Move Immediate Octet MI 
Compare Memory to Immediate CMI 
"AND" on Immediate NI 
"OR" on Immediate or 
Exclusive "OR" on Immediate XI 
Test Under Mask TM 


°o 
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Type 3 instructions consist of: 
= an operation code 
- an operation complement containing the immediate 
operand (operand 1), an 8-bit configuration (*) 


used as a one-character data field in the operation 


~- an address reference to the leftmost octet of the 
non-immediate operand (operand 2) 


Instructions of this type contain no length data since 
operand 2 has an implicit length of one octet. 


After translation into machine language, each Type 3 
instruction occupies four octets of store, as follows: 


5 os os 


' 


4 octets 
Operation Code Operand 2 
Operation Complement Address 


(*) Goded as one alphanumeric (¢) character or a pair of hexadecimal (X) 


digits. 
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Type 4 Instructions 


Type 4 instructions o crate directly upon the eight 
index registers in Core Store. 


There are six Type 4 instructions: 


Load Register LR 
Add Memory to Register AMR 
Subtract Memory from Register SMR 
Compare Register to Memory CMR 
Store Register STR 
Load Address LA . 


Type 4 instructions consist of: 
- an operation code 
- an operation complement containing the name of a 
register, directly specified as operand 71, in the 


three least significant bits of its left -wartet 


-— an address reference for the rightmost octot of 
the operand in store, except for instruction LA 


These instructions contain no length data since both 
operands have an implicit length of 2 octeta. 


86 


APS REFERENCE MANUAL 


After translation into machine language, each Type 4 
instruci.isn occupies four cotets of store,as follows: 


Et 


HH a 


4 octets 


Operation Code 


Operand 2 Address 
Operation Complement A 
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There are twenty-one Type 5 or Jump instructions in the 


GE 130 instruction repertoire, 


They can be divided into three categories based on the 


King of condition tested: 


- those in which the jump execution 


depends on the 


condition of the Central Processing Unit's 


internal indicators: 


Jump on Condition 

Jump on Condition and Return 
Jump if Equal 

Jump if Equal and Return 
Junp if Greater 

Junp if Greater and Return 
Junp if Greater or Equal 
Jump if Greater or Equal and 
Jump if Leas 

Jump if Less and Return 

Jump if Less or Equal 


Return JGER 


Jump if Less or Equal and Return JLER 


Jump if Not Equal 
Jump if Not Equal and Return 


— those in which the jump execution 
conditions, that is, the presence 
error or the condition of certain 
operator's Control Console: 


Jump on Internal Error 


Jump if Switch 1 Set 
Jump if Switch 2 Set 


88 


depends on other 
of an internal 
switches on the 


JIE 
Js1 
JS2 


° 
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- those which specify a jump to be taken regardless of 
the condition of the internal indicators: 


Jump Unconditional pits 
Jump Unconditional and Return JRT 
No Jump Nos 
No Jump ané Return NOUR 


Type 5 instructions consist of: 
~ an operation code 


- an operation complement whose left quartet contains 
information about the conditions in a category 
which are to be tested 


- an address reference to. the leftmost octet of the 
instruction which is to be executed if the specified 
condition is satisfied 


After translation into machine language, each Type 5 
instruction occupies four octets of store, as follows: 


4 octets iy i 
oy 
“Operation Code 
Operation Comploment | eoné t 
or sakes 


Accteta 


| _. | 
Operation Code oe 
Gperatien comprerent | iseas 
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f. Type 6 Instructiona 
There are six Type 6 instructions: 


Halt System Operation HLT 
No Operation NOP2 
Turn OPERATOR CALL Light On LON 
Turn OPERATOR CALL Light off LOFP 


Enable SINGLE-STOP ENS 
Inhibit SINGLE-STOP TNs 
Type 6 instructions consist of: Oo 


~ an operation 


- an operation complement 


After translation into machine language, each Type 6 


inatraction occupies two octets of atore, as followa: oO 

naa ould " a é AE] 
PO To T 

os : oo 
aaa 
Bente Ht ° 
ett rth 
= H ° 
2 octets 


Operation Code 
Operation Complement 
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g- Type 7 Instructions 
There is one Type 7 instruction: 
Call Peripheral PER 
It consists of: 
= an operation code 
— an operation complement which contains the name of the 
Peripheral Unit specified for the operation by the 
first operand 
- an address reference to the leftmost octet of the 


data field named by the second operand 


After translation into machine language, this instruction 
occupies four octets of store, as follows: 


| i orenaron ortnanos 


4 octets 


Operation Code 


Operand 2 


Operation Complement Address 
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h. ‘Type 6 Instructions 
There are two Type 8 inetructions: 


Call Peripheral Indirect PERI 
Load Program Status Register LPSR 


Type 8 instructions consist of: 
- an operation code 


- an address reference to the leftmost octet of the 
data field specified by the operand 


After translation into machine language, each Type & 
instruction occupies four octets of store,as follows: 


wt] se a orenaner 


ration Code 
oe Operand address 


The operation complement field is present but wmsed. 


g2 
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Classification of instructions by APS format 


The primary instructiona are divided into six groups 
according to how they are written on the APS programming 


form. 


~ First group: function code only 


ENS 
INS 


LOFF 


LON 
WOP2 
HLT 


~ Second group: function code and one operand 


JE 


Nos 


JER 
JGR 


~ Third group : function code und two operands 


The first operand is immediate and the second is an 


address. 


or 
NIT 
XI 
™ 
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- Fourth group: function code and two operands 


The first operand is the name of an index register; the 
second is an address, 


LA SMR 
Ik CMR 
AMR STR 


- Fifth group: function code and two operands 


The first operand is an address with a length value not 
eveater than 256 characters; the second operand is an 
address. 


vc SR 
Ne PK 
CMC SL 
OG” I 
xc EDt 
UPK 


~ Sixth group: function code and two operands 


Neither operand has a length exceeding 16 characters: 


MVP NVQ 
cMP cMQ 
AP AD 
SP sD 
MP AB 
DVP SB 
PKS 


94 


APS REFERSNC MANUAL 


APS Macro Instructions 


See paragraph 2.c on page 14 for a general description of 
macro instructions and how to use and translate them. 

The macro instructions for executing operations'of the Cehtral 
Processing Unit (excluding those referring to input/output 
operations) are divided into two groups: 


- control macro instructions 


- arithmetic macro instructions. 


ae Control macro instructions 


These macro instructions interrupt the sequential 
execution of a program in order to call a segment (CALL), 
to make a re-entry to the Operating System when program 
execution has been completed (STOP), to make a re-entry 
+o the Operating Program at any point in program execution 
(ABORT), or to call a subroutine (SUB or *N...N). 


95 


APS REFERENCE MANUAL 


CaLL 
Call Segnent 


DESCRIPTION: this macro instruction calls another program segment at 
any point in the progran. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION COT: CALL 
OPERANDS: - OP. 1 number of the segment to be called 
- OP. 2 address from which program execution is resumed. 


Tt can be expressed by a decimal value or a syibolic name. 
This operand is optional. 


isetestoa Soy Gast 
aa (ae ce el mame 1184 
mel ase oreggyon oreranos H 


+ 
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CONMENT : 


- if operand 2 is a symbolic name and does not appear in the CALL 
section, the name must be defined in the section in which it 
appears by means of the ENTRY instruction 


- the macro instruction CALL can be inserted at any point in the 
program 


- if operand 2 is not used, program execution resumes, after the 


segment call-is requested, from the instruction following the 
CALL instruction. 


ST 
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STOP 


Stop Program and Restart Operating System 


DESCRIPTION: this macro instruction allows re-entry to the Operating 
System after program execution. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: STOP 


OPERANDS; none 


EXAMPLE: 


CENERALG eeecraie 


peat axe 


oPteaton 
ene] wane eo 


rn 4 “ ’ 


orenanos Hl 


i 


NOTE: all programs to be inserted in the organization of the Operating 
System mist end with this macro instruction. 
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SUB 


Call Subroutine 


DESCRIPTION: calls any subroutine present in the library. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: SUB 


OPERAND: subroutine's symbolic name 


HOW IT WORKS: the subroutine called is assembled in the main program 


and the relative addresses are changed to absolute 


addresses. In other words, the actual plant address of 
the subroutine is added to the addresses relative to the 


conven*icral plant address 0. 
The SUR macro instruction is translated with a JRT 
inalraction which jumps to the plant address of the 


assembied subroutine. 


Calling a subroutine ueually requires an initial 


transfer of the operands to certain fixed store areas and 
a subsequent transfer of the results. With regard to these 
usage nerms, which are peculiar to cach program, reference 
should be made to the relevant subroutine mamuals. (See 
Appendix, section B). 
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EXAMPLE: subroutine YSRRN is called after transfer of the value to be 
operated and subsequent transfer of the result. 


sauce es > geet 


PROGR AnaER ATE Shag Se en mae ee o 
Pana perio, bel uf 


NOTE; this macro instruction is also described in part III, section D. 
This macro instruction is normally used in GE 115 programs only, 


because the GE 130 can call subroutines by the macro instruction 
*N...N (see page 101). 
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¥N.. MS” 


Call Subroutine with Parameter Definition 


DESCRIPTION: this macro instruction calls a subroutine present in the 


library which may have been supplied by the software or 
written by the user. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 


OPERATION CODE: *N...N (where N...N is the name of a’ subroutine 
present in the library that does not begin with the 
letter Y. The name of this subroutine without an 
initial Y must have a length of no more than five 
characters.) 


OPERANDS: consist of addresses and lengths and are separated by the 
comma. The addresses can be specified in any way. The 
lengths can be omitted depending on the subroutine called. 
The parameters needed to execute the subroutine are found 
at these addresses. 


HOW IT WORKS: the:subroutine called is assembled in the main program 
and the relative addresses are changed to absolute 
addresses. In other words, the subroutine's actual plant 
address is added to the addresses relative to the 
conventional .planttadd#ess::0. 
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The macro instruction *N...N ie tranelated with a JRT 
instruction to the plant address of the assembled 
subroutine. For each operand an address-form DC 

instruction is made up specifying the address of the 
series of parameters required by the subroutine. 


Por further detaile see the relevant mammals on 


subroutines (Appendix, Section B). 


‘EXAMPLE: 


sun Macrae 


una it 


The subroutine YBILL is called. The parameters necessary for its 
execution are at the address nanted PARI with length 5 and at address 


PAR2 with length 2. 
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ABORT 


Process Abort 


DESCRIPTION: this macro instruction halts processing by making the 
program jump to address 0242 (error HLT of the Operating 
System with GO/NO GO condition: NO). Re-entry to the 
Operating System is made by pressing RUN. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: ABORT 
OPERANDS: none 


EXAMPLE: 


cenenar@ uccraie 


‘os emo (eee ees 
Seen nie 


ortearon aw 
une] wane apeereae OPERANDS 
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Arithmetic macro instructions 
Operand characteristics 


APS 130 provides for five types of macro instructions 
which execute the following arithmetic operations: 


- addition 


subtraction 


multiplication 


- division. 


The operands must always be unpacked and signed. The 
result can occupy the area reserved for one of the 
operands or another area. 


Operand signs 


fo represent the operand signs, the four most significant 
bits of a store position are used conventionally while 
the four least significant bits contain the number's 
binary value. 


Consequently, the negative numbers have the four most 
significant bits equal to 1010. Therefore: 


- 0 = 1010 0000 
- 12 1010 0001 
- 2 = 1010 0010 
- 3 = 1010 0011 


- 9 = 1010 1001 


These store configurations correspond to the characters 
of the graphic set from f to R. 
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The negative numbers ranging from 0 to 9 are, therefore, 
conventionally represented by the following characters: 


~o=-}f -S=N 
-ted -6+0 
-2=Kk -72P 
-351 -8=+@ 
-4206 -9uR 


The numbers with the four most significant bits equal to 
0100 are positive. Therefore: 


+0 = 0100 0000 
+1 = 0100 0001 
+2 = 0100 0010 


+9 = 0100 1001 


A number made up of several figures is considerea negative 
when its least significant figure is negative. Therefore, 
the number -952 is represented in store as 95K. 


Since positive numbers are indicated conventionally with 
the left quartet 0100 corresponding te the norma] left 
quartet of the unsigned numbers, it 1s c.ear that these 
macro instructions can also be used for unsigned numbers, 
since the latter are processed as 1f they were signed 
positively 
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Note that the operands are always processed with MVC 
instructions so that if the operands have a correct 
numeric form of area bits, the result will also be correct 
from this point of view whatever ‘the previous status of 
the result's receiving field may have been. 


Operand lengths 

Operand lengths are variable but must not exceed a certain 
limit, which varies according to the type of macro 
instruction. 

Operand lengths are controlled by the assembly program 
and if they do not conform to the rules, the operand error 


signal is given, 


The following table indicates the maximum operand length 
and the result for each macro instruction. 


4st Operand 


2nd Operand ] 


Macro instruction format: AIS, SDS, MULS, DIVS 


NAME; any name 


OPERATION CODE: ADS for addition 
SDS for subtraction 
MULS for mltiplication 
DIVS for division. 
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OMTPANDS: the maximum number of operands is four. 
‘he first three must bo expressed by a 
symbolic name with no possibility of 
adjustment. Their meanings are as follows: 


- OP. 1 first.term of the operations 
(addendum, minvend, mltiplicand, 
dividend) 


- OP. 2 second term of the operations 
{addendum, subtrahend, mltiplier, 
divisor} 


~ OP. 3 result 


- OP. 4 consists of SH = followed by a 
decimal number ranging from 9 to 15 that 
indicates the number of shifts to be 
executed on the result. In other words, 
the result is slipped to the right (losing 
figures) by as many positions as are 
indicated. 


If, after thie operation, the result las 
a length less than that expected, it 

will be completed with zeroes to the 
left. If the number of shifts indicated is 
more than 15, there is an operand error 
signal. 


Some of these operands are not used. 

By calling A, B, and C the first, second, 
and third operands, the following 
configurations are possible: 

- A, B, C, SH = XX 

~A, B,C 


shifting of the result is not required 
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- A,B 
it is considered like A, B, A 
- A, B, SH = xX 


it is considered as A, B, A, SH = XX 


Translation of macro instructions 


The arithmetic macro instructions are translated as 
follows: 


JRT appropriate subroutine call 
pe AL 3 (a) 

pe AL 3 (B) 

pe aL 3 (¢) 

re AL 1 (value of the shift). 


Type A (binary) DC instructions with expressed length 3 
are translated with the length and address of the field 
indicated in parentheses. In this case, the first three 

DC instructions are translated regpecbively with the length 
and addpess ‘of the first operand (A), the second operand 
(B), andthe result (¢)- 


Subroutines using this method of call are effected by 
means of routines in which certain operations common to 
all or some of the principal subroutines have in turn 
been made routines themselves. As a result, there is an 
obvious saving of storage if several principal 
subroutines should be called. 
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The principal subroutines are: 


- YYSDS 
- YYADS 
- YYMULS 


- YYDIVS 


4. Input/Output Macro Instructions 


See paragraph 2.c, page 14, for a general description of these 
macro instructions, their use, and their translation. 


Input/output macro instructions use subroutines and routines 
that control input/output files. These subroutines and routines 
make up the Input/output Systems described in detail in part IfI. 


These macro instructions are: 
- BIOS macro instructions 


READ Read a Card 

veR Validate Card Reading 

PRINT Print a Line and/or Advance Paper on Printer 
Validate Printout 

LBSS Read Cards and Print 

MIAPE Operate Magnetic Tape Unit 

ver Validate Tape Operation 

TAPE Operate and Validate Magnetic Tape Unit 


ke OR RR RK OK 


- EIOS macro instructions 


+ card files 


OPEN Open File 
GET Read Card 
RLS. Close Operation on Card Reader 
CLOSE Close File 
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« print files 


OPEN Open File 

PUT Print Record 

RLS Close Operation on Printer 
SKIP Paper Skip 

CLOSE Close File 


+ tape files 


OPEN Open File 

GET Read Record 

PuT Write Record 

NEXT Change Volume 

CHKP Store Checkpoint 
RLS Pass to New Block 
CLOSE Close Volume or File 


- input/output subroutine macro instructions: 
CALL Call Subroutines 


+N. ON Command Peripheral Operation 
**N..N Validate Peripheral Operation. 
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III. INFUT/OUTPUT SYSTEMS 


GENERAL INFORMATION 


Inpat/output systems consist of routines and subroutines which command 
control operations on data files that enter Core Store from 

external media and on files that leave store for the peripheral 

units. 


Inpat/output systems are made up of BIOS (Easio Input/Output 
System), BIOS (Extended Input/Output System), and the Input/Output 
subroutines. 


The peripheral units controlled by EIOS and BIOS are the system's 
basic units, that is, a card reader, a printer, and a maximum of 
six magnetic tape units. Input/output subroutines are used to 
control peripheral units supplementary to the basic ones, such as 
card readers and printers other than the first reader or printer, 
tape reader or tape punch, card/punch reader, etc. 


NOTE: to use the input/output systems, one should be familiar 
with the organization of card, print, and magnetic tape 
files as described in Appendix EB. 
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BLOS (BASIC INPUT/QUTPUT SYSTEM) 


BIOS (Basic Input/Output System) is used to process information 
concerning the system's basic peripheral units physically, by 
reading a card or a block on magnetic tape, etc. BIOS gives 
control to BIOS whenever the former must process a physical 
element. 


BLOS consists of a series of routines, each of which controls 
a given peripheral. It is part of the supervisor and is always 
located in store during operation of the system. 

BIOS permits the overlapping provided for by the GE 130 
hardware, as well as non-standard processing. Its routines are 
called by two types of macro instructions: Command for the 
execution of peripheral operations, and Validation, for the 
execution of error,end—of-file, and unit-out-of service tests, 
etc. 

The BIOS macro instructions are as follows: 


+ for card reading 


*READ Read a Card 
*VCR Validate Card Reading 


« for printing 


*PRINT Print a Line and/or Advance Paper on Printer 
*VPR Validate Printout 


« for reading and printing 


*LESS Read Cards and Print 
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. for reading from magnetic tape and writing 
*MEAPE - Operate Magnetic Tape Unit 


*VMT = - Validate Tape Operation 
*TAPE - Operate and Validate Magnetic Tape Unit 


A detailed description of these macro instructions is given on the 
following pages. 
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*READ 
Read a Card 


DESCRIPTION: this macro instruction calls the BIOS card read routine and 
commands its execution. 


MACRO InSPRUCTION FORMAT: oO 


HAME: any name 
OPFRATION CODE: *READ 
OPERAND: symbolic address of the area containing the parameters 


required for the read operation. 


The parameters, which must be defined by DC instructions, 
are as follows: 


° 


where: 


f = 00 if the card is to be read on channel 1 
= 20 if the card is to be read on channel 3 
L = number of characters to be read, less 1 


II = address of the read area. 
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HOW IT WORKS: the assembler translates this macro instruction into the 
following two instructions: 
RT 728 
De AL2(PAR) 
The first instruction jumps to the initial address of the 


BIOS card read routine while the second defines the start 
address of the area containing the parameters. 


EXAMPLE: the routine is called to read on channel 1 a card with length 
60 in the area named FIELD. 


semtaat @ tuecraic seeminesron perme | 
on pct [ea = ees ae 
APs prochaine tom sae Eee || 
z 
Nod aes! oer oreRavos 5 
" i "plol* T 


Wafabaosenah 
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*VCR 
Validate Card Reading 


DESCRIPTION: this macro instruction is for validation of card reading, 
previously commanded by the *READ macro instruction. 


MACRO INSTRUCTION FORMAT: 
NAME: any name 
OPERATION CODE: *VCR 


OPERAND: symbolic address of the area containing the parameters 
required for the read operation. These parameters are 
the same as those for the *READ macro instruction. 


HOW IT WORKS: the assembler translates this macro instruction into the 
following two instructions: 


SRT 732 
De AL2(PAR) 
The first instruction jumps to the BIOS validate reading 


routine while the second defines the start address of the 
area containing the parameters. 


At the end of the validation operation, the ur/or and 
28/NZ indicators can assume the following configurations: 
10 for operation validation 


Ot for end-of-file. 


116 


APS REFERENCE MANUAL 


EXAMPLE: the card read routine is called and the operation is then 
validated. 
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* PRINT 


fvint a Line and/or Advance Paper on Printer 


DESCRIPLION: tiis macro instruction calls the print routine and/or the 
H1O0S paper movement and commands its execution. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: *PRINT 
OPERAND: symbolic address of the area containing the required 


parameters for the print operation. 


The parameters, which mist be defined by DC instructions, 
are as follows: 


where: 
{ = 00 if printing is required on channel 1 with 
non—integrated printer 


= 01 if paper movement is required on channel 1 
for non-integrated printer 


10 if printing is required with integrated printer 
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11 if paper movement is required for integrated 
printer 


8 


20 if printing is required on channel 3 with 
non-integrated printer 


a 


21 if paper movement is required on channel 3 for 
non~integrated printer 


a 
a 


any character, for the routine's work functions. 


HOW IT WORKS: the assembler translates this macro instruction into the 


foliowing two instructions: 


JRT 736 

DG AL2 (PAR) 
The first instruction jumps to the start address of 
the BIOS print and paper movement routine while the 


second defines the start address of the area containing 
the parameters. 


The information to be printed mst be located starting at 
address 514 for a length of 160 store positions. 


The value 00 must always be located in store position 
512. 
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A paper movement code must be placed in store postion 513, 
assume one of the following values: 


and can 


(ole) 
Ot 
02 
03 
04 
05 


no paper movenent 

skip controlled by track 1 of VFU 
skip controlled by track 2 of VFU 
skip controlled by track 3 of VIU 
skip controlled by track 4 of VFU 
skip controlled by track 5 of VFU 
skip controlled by track 6 of VEU 
skip controlled by track 7 of VFU 
single line feed 

double line feed 

triple line feed 

set unit to manual (operator call). 


The codes located in positions 512 and 513 must be reset 
after each command. 


At the end of the print operation, the UF/OF and Z8/NZ 
indicators can assume the following configurations: 


10 for end-of-operation 


1 


for end-of-page. 


EXAMPLY: print routine is called on channel 1, with 2 non-integrated 
printer, and a triple line feed is executed. 
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*VPR 


Validate Printout 


DESCRIPTION: this macro instruction is for validation of printout, 
previously commanded by the *PRINT macro instruction. It is 
not necessary when the *PRINT macro instruction 1s used 
for paper movement only. 


MACRO INSTRUCTION FORMAT: 


NAME; any name 
OPERATION CODE: *VPR 


OPERAND: the symbolic address of the area containing the parameters 
required for the print opera*ion. These parameters are the 
same as those for the *PRINT macro instruct:on. 


HOW IT WORKS: the assembler translates this macro instruct:on :nto the 
following two instructions: 


ORT = 740 
pe AL2 (PAR) 
The first instruction jumps to the validate printout 


routine while the second defines the start address of the 
area containing the parameters. 
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At the end of the validation operation, the UF/OF and 
ZB/NZ indicators can assume the following configurations: 


10 for operation validation 


0O for print error 
O1 for unit-out-of-service, 


EXAMPLE: the print routine is called and the operation is then validated. 
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*LBSS: 
Read Cards and Print 


DESCRIPTION; this macro instruction calls the routine that will execute 
card rend and print operations simultaneously or read or print 


operations singly. 


This macro instruction is used only for programs written in 
APS 115 and re-compiled in ETOS. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: *LBSS 
OPERAND:, symbolic address of the area containing the necessary 


parameters for the operation. 


The parameters, which mst be defined by DC instructions, 
are as follows: 
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Tf = type of performance required, which can assume 
the hexadecimal values: 


00 for simultaneous read and print 
Ot for print only 
02 for read only 
03 for paper movement or operator call 


_ ~ length of card to be read, less 1, in binary 


II = address of the area of the card to be read, in 
binary 


S = type of paper movement and operator call. It can 
assume the following hexadecimal values: 


set unit to manual 
skip controlled by 
skip controlled by 
skip controlled by 
skip controlled by 
akip controlled by 
skip controlled by 
skip controlled by 
no paper movement 
single line feed 
double line feed 
triple line feed 


(operator call) 
track 1 of VFU 
track 2 of VFU 
track 3 of VFU 
track 4 of VFU 
track 5 of VFU 
track 6 of VEU 
track 7 of VFU 


Pr print only operations it is sufficient to specify 
.aramevers T and 8, Parameters L and II can have any value. 
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HOW IT WORKS: “he assembler translates this macro instruction into the 
following two instructions: 


oRT 108 
DC AL2(PAR) 


The first instruction jumps to the start aadress of the 
card read and print routine while the second defines the 
start address of the area containing the parameters. 


The information to be printed must be located starting at 
address 514 for a length of 160 store positions. 


Upon re-entry from the subroutine, the UF/OF and Z8/NZ 
indicators can assume the following configurations: 


- after call for read and print 


o1 if end-of-cards 
00 if print error 
10 if everything OK. 


These configurations are mutually exclusive. Por 
example, in the event of end-of-cards, printing 
is not executed. 


- after call for print only 


0O if print error 
10 .f everything 0K 


- after cali for read only 


01 if end-of-caras 
10 if everything OK 
- after cail for paper movement 


11 if there is an end-cf-form signal tefore 
starting the paper movement. The paper 
movement is executed all the same. 


10 - in other cases. 
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EXAMPLE: the routine for simultaneous reading and printing is called. The 
card read area is located at address 5500 with length 80. 
Printing must be executed with a skip controlled by track 2 of 


the VFU. 
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*MPAPE 


Operate Magnetic Tape Unit 


DESCRIPTION: this macro instruction calls the magnetic tape processing 
routine used for reading, writing, rewinding and erasing 
the tapes, etc. 


MACRO INSTRUCTION FORMAT; 


NAME: any name 
OPERATION CODE: *MPAPE 
OPERAND: symbolic address of the area containing the required 


parameters for the operation. 


The parameters, which mist be defined by DC instructions, 
are as follows: 


Peer 


V27 


where: 


T 


LL 


II 
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O if an operation is required on channel 1 


if an operation is required on channel 3 


QO block read forward 
1° block run backward 
dlock writing 
vewinding 

erasing 


rewinding and putting unit in manual 


A Wk wen 


block read backward 

For t = 3, 4, and 5, the channel is not considered. 
length of reading or writing 

decimal address of the area containing the block 
to be written or the area that is to receive the 
block read. 


field for block counting if the blocks are numbered 


external name of tape unit concerned (it can 
assume values from 1 to 8} 


indicates the type of control provided for in 
reading or writing: 


0 for transverse parity 
P for transverse disparity 


indicates writing density: 
K for a density of 1600 bpi 
L for a density of 800 bpi 


M for a density of 556 bpi 
N for a density of 200 bpi 
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8 


decimal address of a possible routine to be 
executed in case of error or unit out of order. 
If the routine does not exist (EE = 0) an HLT 
instruction is executed in case of error. 


0 = 00 for reading and writing unnumbered blocks 


01 for reading and writing numbered blocks 


02 for reading with packed unnumbered blocks 
(this is always done on channel 1) 


u 


03 for reading or writing the first block of a 
reel 


04 for writing a tape mark. 


HOW IT WORKS: the assembler translates this macro instruction into the 
following two instructions: 


SRT 720 
DC AL2(PAR) 
The first instruction jumps to the start address of the 


BIOS tape routine while the second defines the start 
address of the area containing the parameters. 


If when rewinding or erasing (parameter + = 3 or 4) the 
unit out-of-service condition occurs, the routine jumps 
to the address expressed in parameter EE (for EE # fe) 
with UF/OF = 1 and 28/NZ = 0). 
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EXAMPLE: the subroutine is called to write a tape block on channel 1. 
The other features of the operation are: an unnumbered block 
300 characters in length, located at address 5000, use of tape 
unit 2, transverse parity, a density of 556 bpi, and no error 
routine. 
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*VMT 


Validate Tape Operation 


DESCRIPTION: this macro instruction is for the validation of a tape 
Operation, previously commanded by the *MTAPE macro 


instruction. It must be used after the block read, write, 
and run backward operations. 


MACRO INSTRUCTION FORMAT: 


WAMEE any name 
OPERATION CODE: *VMT 


OPERAND: symbolic address of the area containing the necessary 


parameters for the magnetic tape operation. These parameters 
are the same as those for the *MTAPE macro instruction. 


HOW IT WORKS: the assembler translates this macro instruction into the 
following two instructions: 


TRT 724 


DG -AL3( PAR) 


The first instruction jumps to the BIOS validate tape 
operation routine while the second defines the start 
addreas of the area containing the parameters. 
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At the end of the validation operation, the UE/OF and 
2B/NE indicators can assume the following configurations: 
10 for operation validation 


"1 for tape mark noticed in reading or a block run 
backward 


01 for end of medium at output. 
If an error is noted during the validation routine, the 
program jumps to the address established by the parameter 
Es # 0. Then the configurations are as follows: 

10 = for unit-out-of-service 


"1 for block number error(for numbered blocks read 
forward or backward) 


01 for persistent read or write error. 


EXAMPLE: the magnetic tape routine is called and the operation is then 


validated. 
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*TAPE 
Operate and Validate Magnetic Tape Unit 


DESCRIPTION: this macro instruction calls the magnetic tape processing 
routine and the subsequent validation of the operation. 
Its use is equivalent to the use of the *MTAPE followed 
by the *VMP macro instructions for tape read, write, and 
run backward operations (parameter + = 0, t, 2, 7). When 
rewinding, erasing, rewinding, and with the unit in 
manual (parameter t = 3, 4, 5), the use of the *TAPE 
macro instruction is equivalent to the execution of the 
*HDAPE macro instruction without the validation 
operation. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: *TAPE 
OPERAND: the symbolic address of the area containing the required 


parameters for the operation. 


For a description of the parameters required by the *TAPE 
macro instruction, see the description of the *MTAPE macro 
instruction. 
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HOW If WORKS: the assembler translates this macro instruction into the 
following two instructions: 


ORT 104 
pC = AL2( PAR) 


The first instruction jumps to the start address of the 
BIOS tape routine while the second defines the start 
address of the area containing the parameters. 


At the end of the tape operation, the indicator conditions 


are the same as those described for the *MTAPE and *VM? 
macro instructions. 
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EIOS (EXTENDED INPUT/OUTPUT SYSTEM 


The command and control operations of the input/output files, 
required by the use of the basic peripheral units, are 
executed by a series of subroutines that make up the Extended 
Input/Output System (BIOS). 


EIOS is a group of closely connected subroutines which process 
information both physically and logically. The physical processing 
is carried out with the help of the BIOS routines. 


The subroutines making up EIOS are written, together with other 
subroutines, in the subroutine library and are used by means of 

the appropriate APS language macro instructions, called input/output 
macro instructions, after the files to be processed have been defined 
by toe FILE declarative instructions. 


The input/output macro instructions are divided into three groups 
according to the type of peripheral unit used by the file to be 
processed: 


ae macro instructions for processing card files. For each read 
request made by the main program, the subroutine called by 
the macro instruction reads a card in the block area and 
starts-the reading of the next card. This permits the use of 
overlapping provided by the system's hardware. 


db macro instructions for processing print files. These macro 
instructions are also designed to permit the overlapping 
provided by the system's hardware. 


Ce macro instructions for processing magnetic tape files. 
For each read request made by the main program, the subroutine 
called by the macro instruction makes a record available, as 
follows: 


- if the file is organized in blocks consisting of a single 
record, the record is supplied in the block area 
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-— if the file is organized in blocks consisting of several 
records, there are two cases: 


. if provision was made for using the work area in the 
file's FILE, the record is supplied in this area 


» if provision was made for using an index register in 
the file's FILE, the address of the record located in 
the block area is placed in the register. 


For each write request made by the main program the subroutine 
considers the logical record to be written, as follows: 


- if the file is organized in blocks consisting of a single 
record, the record in the block area is written on tape 


- if the file is organized in blocks consisting of several 
records, there are two cases: 


« if provision was made for using the work area in the C+) 
file's FILE, the record in the work area is transferred 
to the block area 


+ if provision was made for using an index register in 
the file's FILB, the record whose address is in the 
register is transferred to the block area, 


INPUT/OUTPUT SUBROUTINES 


The input/output and check operations relative to the control of 
peripheral unite different from the basic peripheral units (such as 
card readers and printers other than the system's firet reader and 
printer, card/punch reader, etc.) are executed by a series of 
input/output subroutines supplied by the software or written by the 
user and which are located in the subroutine library. 
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These subroutines are called by the following macro instructions: 


SUB Call Subroutine 
*N..N © Command Peripheral Operation 
**N,.N Validate Peripheral Operation 


Many input/output subroutines consist of two phases. The first, the 
Command phage, executes the peripheral operation (for example, reads 
a card, writes a block on tape); the second, the Validation phase 
validates the operation carried out and includes error, end-of-file, 
and unit-out-of service tests, etc. 


The Command phase of a subroutine is called by the macro 


instruction *N..N, while the Validation phase is called by the macro 
instruction **N..N. 


As 
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SUB 


Call Subroutine 


DESCRIPTION: this macro instruction is used to call a subroutine 
present in the library which is to be used to control a 
peripheral unit. 


MACRO INSTRUCTION FORMAT; 


NAME: any name 
OPERATION CODE: SUB 
OPERAND: symbolic name of subroutine oO 


HOW IT WORKS: the subroutine called is assembled in the main program 
and its relative addresses are changed to absolute 
addresses. In other words, the subroutine's actual plant 
address is added to the addresses relative to the conventional Oo 
plant address 0. The SUB macro instruction is translated 
with a JRT instruction that jumps to:the assembled subroutine's oO 
Plant address. 


Regarding the usage norms, which are peculiar to each 


program, reference should be made to the relevant subroutine 
manuals (see Appendix B). 
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EXAMPLE: YABCD subroutine call. 
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This macro instruction is normally used in GE 115 programs only. The 


GE 130 can in fact call out an 1/o subroutine by a macro instruction 
.*) *N..N for Command and a macro instruction **N,.N for Validation, (aee 
pages 140 and 142). 
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*NL ON 


Command Peripheral Operation 


DESCRIPTION: this macro instruction is used to call a subroutine present 
in the library and which is meant to control the peripheral 
unite. For the subroutines consisting of a Command and a 
Validation phase, this macro instruction executes the Command 
Phase only. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 


OPERATION CODE: *N..N (N..N is the name of a subroutine present in 
the library without the initial letter Y. The 
subroutine name without the letter Y must have a 
maximum length of four characters.) 


OPERANDS: they consist of addresses (and lengths) and are separated 
by the comma. The addresses can be specified in any way. 
The lengths can be omitted depending on the subroutine called. 
The parameters needed to execute the subroutine are found 
at these addresses. 


HOW IT WORKS: the subroutine called is assembled in the main program 
and its relative addresses are changed to absolute 
addresses. In other words, the subroutine's actual plant 
address is added to the addresses relative to the 
conventional plant address 0. 


The macro instruction *N..N is translated with a JRT 
instruction at the plant address of the assembled 
subroutine and an address-form DG instruction is made up 
for each operand, specifying the address of the parameter 
series required by the subroutine. 
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Regarding these usage norms, which are peculiar to each 
program, reference should be made to the relevant subroutine 
manuals (see Appendix B). 


EXAMPLE: an example concerning the macro instruction **N..i and which 
includes the use of the macro instruction *N..N follows on page 143. 
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*4N,N 


Validate Peripheral Operation 


DESCRIPTION: this macro instruction starts the Validation phase of the 
subroutine previously called by the macro instruction 
*N. Ne 


The use of a subroutine to control peripheral units by means 
of the two macro instructions *N..N and **N..N allows 


overlapping between peripheral unit operations and internal 
processing, 


MACRO INSTRUCTION FORMAT: 


NAME: any name 


OPERATION CODE: **N..N (N..N is the name of a subroutine present 
ain the library without the initial letter f: without 
the letter Y, the subroutine name must have a 
maximum length of four characters). 


OPERANDS: they consist of addresses (and lengths) and are separated 
by the comma. The addresses can be specified in any way. 
fhe lengths can be omitted depending on the subroutine 
called, The parameters needed to execute the subroutine 
are found at these addresses, 


HOW IT WORKS: before using the macro instruction **N..N the subroutine 
YN..N must have been called in store by macro instrucstion 
*N. Ne 


142 


APS REFERENCE MANUAL 


The macro instruction **N..N is translated with a JRT 
instruction to the plant address + 4 of the assembled 
subroutine, while a DG instruction in address form is 
set up for each operand specifing the address of the 
parameter series required by the subroutine. 


EXAMPLE: this sequence of instructions effects the overlapping of the 
reading of a card and of the internal processing of the card 
read previously. 
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The *CRZ2 macro instruction on line 020 calls the card-read 
subroutine YCRZ2 out of cycle. With the execution of the 
Command phase, this assembles the subroutine. 


The **CRZ2 macro instruction on line 060 executes the 
subroutine's Validation phase. 


The *CRZ2 macro instruction on line 090 reads the cards in 


cycle and returns to the **CRZ2 macro instruction on line 60 
for validation of the operation. 
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In order to guarantee the correct overlapping between the time 
for reading a card and the time for processing the previous card, 
two memory areas, A and B, have been provided. A receives the 
card just read while B receives the contents of the card read 
oreviously. 


Data for internal processing are taken from memory area B. 
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INPUT/OUTPUT MACRO INSTRUCTIONS (EI0S 


The BIOS subroutines are called by the appropriate macro 
instructions which are divided into three groups according to 
the type of peripheral units used by the file: 

a. macro instructions for card files 


vb macro instructions for print files 


Ce macro instructions for magnetic tape files 


NOTE: the use of these macro instructions assumes that the file 
has been defined by a FILE declarative instruction. 


1. (Card Files 


The following macre instructions relative to the processing of 
card files are described on pages 146-151: 


OPEN Open File 
GET Read Card 
RLS Close Operation on Card Reader 
CLOSE .Close Pile 
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OPEN 
Open File 


DESCRIPTION: this macro instruction opens a file, that is, it checks the 
Pile and reads the first card. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: OPEN 
OPERAND: symbolic name of file 


HOW IT WORKS: the macro instruction reads the first file card into the Card 
Read Area, 


EXAMPLE: Opening of ENTRY file. 
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GET 


Read Card 


DESCRIPTION: this macro instruction writes the card read in the area 
indicated by the program. 


MACRO INSTRUCTION FORMAT: 
NAME: any name 
OPERATION CODE: GET 
OPERAND: symbolic name of file 


HCY IT WOU“S: the macro instruction executes the following functions: 


- it moves the contents of the card previously read in the Card 
Read trea to the area specified by the BA operand in the 
SILT instruction 

~ it reads the subsequent card into the Card Read Area 


- it re-enters the main program or starts the end-of-file 
routine. 
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EXAMPLE: read an IN file card. 
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RLS 


Close Operation on Card Reader 


DESCRIPTION: this macro instruction must be used only before a CHKP 
macro instruction is executed. It is used to end the 
reading of a card before starting the checkpoint execution. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: RLS 
OPERAND: symbolic name of file 


HOW IT WORKS: the assembly program translates this macro instruction 
into a subroutine call that carries out the function 
described. 
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EXANPLE: checkpoint executed on the OUT file preceded by an RLS executed 
cn the CARD file. 
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CLOSE 
Close File 


DESCRIPTION: this macro instruction closes the file and is not obligatory. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: CLOSE 
OPERAND: symbolic name of file 


HOW IT WORKS: the assembler translates this macro instruction into an 
instruction that writes a specific character in a given 
position of the files table. 


EXAMPLE: close the INPUT file. 
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The following macro instructions relative to the processing of | 
print files are described on pages 153-159. 


OPEN 
Pur 
RLS 
SKIP 
GLOSE 


Open File 

Print Record 

Close Operation on Printer 
Paper Skip 


Close File 
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OPEN 
Open File 


DESCRIPTION: this macro instruction opens a file and must precede the 
other operations relative to that file. 


MACRO INSTRUCTION FORHAT: 


NAME: any name 
OPERATION CODE: OPEN 
OPERAND: symbolic name of file 


HOW IT WORKS: a character is placed in a given position of the files 
table to indicate that the file has been opened. 


EXAMPLE: open OUT file. 


eraemac@ ruccrae seommesron 


(OE- 100 semis ees =< 
APS PROGRAMING FORM eT 


cme | wane 


orenanos F 


153 


APS REFERENCE MANUAL 


PUT 
Print Record 


DESCRIPTION: this macro instruction prints the record in the block 
area (whose address is indicated by parameter BA of the FILE 
instruction) preceded, if necessary, by a paper movement. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODB: PUT 
OPERAND: symbolic name of file 


HOW IT WORKS: the macro instruction carries out the following operations: 


- it confirms the previously executed print operation. In 
case of an error or printer out-of-servioe, it starts- 


the routine written by the programmer. It writes in 
register 7 the address of the macro instruction that gave 


the errors 


- it executes the paper movement when required.(see Appendix E). 


- it prints the record present in the print block area. If 
the end-of-form signal is given, the subroutine jumps to 


the user routine whose address is supplied by the parameter 
EV of the FILE declarative instruction. 
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EXAMPLE: printing a record of the file naned PRINT. 


ern a ee 
GE - 100 SERIES. * i 


APS PROGRAWUNG FORE 


ume | mane 


Fo 
e 
Fi 
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RLS 


Close Operation on Printer 


DESCRIPTION: this macro instruction must be used only before a CHKP 
macro instruction is executed. It is used to terminate the 
last print operation commanded before starting the 
checkpoint execution. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: RLS 
OPERAND: symbolic name of file 


HOW IT WORKS: the assembly program translates this macro instruction into 
the subroutine call that executes the function described. 


EXAMPLE: a checkpoint executed on the OUT file preceded by an RLS 
executed on the STAMP file. 


sence @cuccrae swomraren ince 
rose LLL 
2] 
a weniger ; 
Le aut 
ET H 
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SKIP 
Paper Skip 


DESCRIPTION: this macro instruction executes a paper movement, such as a 
line feed, skip to a new sheet, etc. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: SKIP 
OPERAND: symbolic name of file 


HOW If WORKS: the macro instruction carries out the following operations: 


~ it confirms the print operation executed previously. In 
the event of error or out-of-service, it starts the 
routine written by the programmer. It writes in register 
7 the address of the macro instruction that gave the 
error. 


- it executes the required paper movement. If the 
end-of-sheet signal is given, the subroutine jumps to 
the user routine whose address is supplied by the 
parameter EV of the PILE declarative instruction. 
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EXANPLE: execution of a double line feed. 


cemenar@® tuecrae 
or. weseues 
Ps ProcRaminc rome 


a v orenanos A 


idola® 
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CLOSE 
Close File 


DESCRIPTION: this macro instruction executes the file closing operations. 


MACRO INSTRUCTION FORMAT: 
NAME: any name 
OPERATION CODE: CLOSE 
OPERAND: symbolic name of file 


HOW IT WORKS; the macro instruction executes the following operation: 


- confirms the previously executed print operation. In the 
event of error or printer out-of-service, it starts the 
routine written by the programmer. It writes in register 
7 the address of the macro instruction that gave the 
errors 


EXAMPLE: closing the STAMP file. 


semen @uccraie 


(GE - 100 SEES, 
APS PROGRAMING FORM 


time | sane onenaton orenanos Hl 


159 


Magnetic Tape Files 


APS REFERENCE MANUAL 


A description of the following macro instructions relative to the 
processing of tape files is given on pages 161-176. 


OPEN 


cET 


Fur 


NEXT 


Open File 

Read Record 

Write Record 
Change Volume 
Store Checkpoint 
Pass to New Block 


Close Volume or File 
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OPEN 
Open File 


DESCRIPTION: this macro instruction opens a file, that is, it executes 
all those positioning and control operations usually referred 
to as file opening. (See GE 130 EBTOS manual, Appendix B, for 
file opening, use of LBC card.) The OPEN macro instruction 
must always precede all the operations relative to a file. 


For files with non-standard labels, the macro instruction 
OPEN calls the routine provided for by the user. Normal 
re-entry is at the instruction following the OPEN macro 
instruction. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: OPEN 
OPERANDS: - OP. 1 symbolic name of file 
- oP. 2 1/0 
indicates the type of file opening. It can have one of 
the following values: 
T file opened at input 
QO file opened at output 
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HOW IT WORKS: making provision for maximum controls which can, however, he 
limited by the file opening cards, the OPEN macro 
instruction executes the following operations (for files 
organized in standard mode): 


For input files: 


- Checks that the file is present on the indicated unit. 


If the option FA (File Absent = punch ¥ in column 49 of 
card LBC) is present in the file opening card, the file's 
opening procedure is interrupted. 


~ Checks that the file has not yet been opened. However, the 
file can be reopened provided it has already been closed. 


= Checks that the first block is the tape header label VOL? 
(INT for 7+track tapes). 

~ Reads the second label (HDR1) and checks data accuracy: 
« File name 
. file serial nunber 


» volume sequence number 
+ file creation date 


The file name, the file serial namber, and the. creation 
date, mist correspond to the data indicated in the file 


opening card. 


The check on the volume sequence number is done by 
a counter controlied by the macro instruction. 


- Positioning on tape immediately before the first block 
of information. 


When the procedure has .been completed,re-entry is made to 
the main program. 
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Por output files (i+ is assumed that the volumes used are 
labelled): 


~ Checka that the file is present on the first label 
(VOLt or INT?) and reads HDR1 in store. 


- Checks reel validity: 


+ file name 

» £ile serial number 

« volume sequence number 
« purge date 


The purge date on the HDRi label read from tape mst 

be less than or equal to the file registration date 
expressed in the file opening card. The comments made 
above under input files about file name, file serial 
number, and volume sequence number are equally valid for 
the output files. 


— Checks that the file has not already been opened. The 
file can be reopened provided it has been closed and 
is a monovolume file. 


-- Prepares the HDR1 label and writes it on tape, followed 


by a TM. 
- Inserts areas in the files table. 


Wren the procedure has been completed, re-entry is made to 
the main program. 


EXAMPLE: opening of the INPUT file at input. 


cemenat @ ceric 


QE 100 SERIES 


wr Peon tn ree, OTT 


mae 


orensron | 
abe 


fittees] HSER 
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GET 
Reag Record 


DESSRIPTION: the macro instruction GET processes the input file logically, 
As well as reading the physical record from tape and 
checking end-of-file or end-of-volume, it transfers the 
records from the block area to the work area if the latter 
is present. Otherwise the record address is supplied in the 
index register. 


If the file records have a UN orgenization (single=record blocks) 
the macro instruction GET proceeds by physical elements, 
that is, it reads one block at a time and writes it in the 


BA. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPRATION CODE: GET 
OPERAND: symbolic name of file 


HOW JT WORKS: the macro instruction transfers a single record at a time 
from the BA to the WA. Each time a block has been complete~ 
ly processed, a new block is automatically read in the BA. 
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In the event of end-of-file or end-of-volume, the user~ 
programmed routine is started and declared by the parameter 
EV of the FILE instruction. The address of the first 
instruction after the GET macro instruction is stored in 
index register 7. Furthermore, the routine transfers the 
characters EOQV for end~of-volume and EOF for end-of-file to 
the first three positions of the BA. 


Note that this routine carries out only those checka 
specifically requested by the program. It will not 
execute general operations, such as final tag check, tape 
vrewind,and reel change, which are carried out by the macro 
instructions CLOSE and NEXT. 


If the Fa option is present on the file opening card 
(FILE Absent = Y punched in column 49 of card LBC), the 
execution of the first GET macro instruction tranemits 
the end-of-file signal. 


EXAMPLE: reading a record of the INFUT file. 


senna @ eucerare roowninestion pores He 
OE. 100 semes pe 
Ps Procesuune Fon Al 
| 
vine | ae ore orenanos ear si 


fe CTT 


=f t-te EE tt tt 
=e 
it 
Ht 
Tr 
Coe 
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Pur 
Write Record 


DESCRIPPION: depending on the format of the file records supplied by 
the user in the FILE instruction, the macro instruction PUT 
checks the writing of a bloek (if its format is UN) 
or transfers a record from the work area (or from the area 
whose address is indicated in the index register) to the 
block area and registers the latter area on tape when it is 
complete. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 
OPERATION CODE: PUT 
OPERAND: symbolic name of file 


HOW IT WORKS: the user supplies a recordeto the WA. The PUT macro 
instruction transfers the record to the area containing 
the block being formed (BA). The block is registered 
automatically when it is complete. The PUT macro 
instruction causes a block to be written each time it is 
called if the file is made up of single-record blocks. The 
end-of-medium signal causes a jump to the routine prepared 
by the user and declared by the parameter EV of the FILE 
instruction. 
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This routine must carry out only those checks required 

ty a g.ven program and not the generic closing operations, 
euch as writing the final label, rewinding, and volume 
change, which are executed by the macre instructions CLOSE 
and NEXT. 


Writing a block involves the following operations: 


= bicck numbering, if required in the FILE instruction 


- checking for writing errer. 


EXAMPLE. writing a record on the OUT file. 


seweaa @ tucerme sooerncanon yore AF 
APS PROGRAMING FORM eC 


orenston 
ume | wane ears OPERANDS 


ra 
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NEX? 


Cnange Volume 


DESCRIPTION; +his macro instruction allows processing to be continued 
on the alternate tape unit that is specified in the FILE 
instruction. 


MACRO INSTRUCTION FORMAT: 


NAME any name 
OPERATION CODE: NEXT 
OPERAND: symoolic name of file 


HOW IT WORKS the macro instruction-is used only for files organized 
in standard mode and executes the following operations: 


- For input files: 


» rewinds reel 
. updates parameters for reel change 
reads and checks. the labels of the new reel 


positions the new reel in front of the first 
working block. 
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- For output files: 


» Pewinds reel 
» updates parameters for reel change 
+ reads and checks the labels of the new reel 


» writes the new HDR1 label 


EXAMPLE: volume change and closing of the ARCH file. 


orenanos : ; 


aaa 


ire 
re 


NOTE: executzcn cf the NEXT macro instruction aesumes that the file has 
alveady been clesed by the CLOSE macro instruction. 
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CHKP 


Store Checkpoint 


DESCRIPTION: this macro instruction interrupts the normal block 
sequence of an output file in order to write a checkpoint, 
that is, all the information (store content, file positioning, 
etc.) required to resume the program from the point where the 
writing took place. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 

OPERATION CODE: CHKP 

OPERANDS: - OP. 1 symbolic name of the file on which the writing 
takes place. The file should have been opened at cutput. 


- OP. 2 PR — this operand is optional. If present, 
an area is printed which is incremented by 1 each time 
the OHKP macro ‘instruction is executed. 
The printed message has the following form: 
EXECUTED CHKP N.XXXX ON VOLUME YVYYYY 
in which XXXX is the number of checkpoints printed and 
YYYYYY indicates the serial number of the volume on 


which the file is written. 


~ OP. 3 HT — this operand is optional. If present, 
processing stops at an HLT after executing the CHKP. 
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- OP. 4 (address) 


This operand, by means of a symbolic name or a decimal 
value, represents the start address of a routine prepared 
by the user and started by the recovery program (.RST) 
before restarting the main program. This operand is 
optional. 


HOW IT WORKS: the macro instruction writes the following on the indicated 


files 


— tape mark 


label containing the restart address 


two blocks containing information used by the restart 
program 


a@ block containing the store content 


— tape mark. 


EXAMPLE: writing a restart point on the OUT file, with signal printout. 


NOTE: 


seme @ eerie oes feomneares jcapanull 


the execution of the macro instruction CHKP assumes that the file 
is standard and that it is contained on a 9-track tape. An RLS 


macro instruction for card file and/or an RLS macro instruction 
for print file, must precede a CHKP macro instruction, if the 
program uses card and/or print files. 
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RLS 


Pasa ‘co Rew Bicck 


DESCRIP! ION: vhis wacro instruction interrupts the processing of a block 
te go on to process the next block. It has no meaning if the 
file consists of single-record blocks (parameter UN of the File 


peat guchicn). 


MACRO INSTRUCTION FORMAT: 


NAME. any name 
OPERATION CODE: RLS. 
OPERAND: symbolic name of file 


HOW IT WORKS: for input files, the macro instruction causes all the 
non-processed files present in the BA to be discarded, 
with the result that the next GET macro instruction 
reads a new block. 


Fer output files, the macro instruction writes the content 


of the BA if the latter is not yet complete. The next PUT 
macro instruction begins the formation of a new block. 
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EXANPLE: after a comparison of the key of the last record read in the 
ALPHA file with the K1 field, read the first record of the next 


block. 


ranase la] 
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CLOSE 


Close Volume or File 


DESCRIPTION: the processing of an input or an output file ends when the 
file is closed by this macro instruction. File closing is 
not mandatory except when the file has to be reprocessed 
and, therefore, reopened. 


MACRO INSTRUCTION FORMAT: 


NAME: any name 

OPERATION CODE: CLOSE 

OPERANDS: - OP. 1 symbolic name of file 
- OO. 2 UL/N 


.UL ‘this parameter causes the reel to be rewound and 
the unit to be put into manual. It is not conside— 
red for non-standard files. 


«N this parameter maintains the positioning of the 
tape after execution of the CLOSE magro instruction. 


The operand OP.2 may be absent; in this case the reel 
is only rewound. 
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HOW IT WORKS: making maximum provision for controls which may, however, be 
limited by the file opening cards, the CLOSE macro 
instruction executes the following operations (for files 
organized in standard mode): 


For input files: 


Checks for the presence of the file that should be open, 


Checks to see that the block numbers are equal if the 
file is standard. 


- Winds reel according to the type of operands indicated 
in the instruction. 


Effects re-entry to the main program. 

For output files: 

— Writes, if necessary, an incomplete block present in the BA. 
- Writes a tape mark. 

- Writes a final label (EOV or EOF). 

~ Writes two tape marks. 


- Rewinds reel according to the type of operands indicated 
in the instruction. 


- Effects re-entry to the main program. 
If a CLOSE macro instruction is issued before the trailer 
label is read on an input file, the subroutine does not 


perform any check and positions the tape as specified by 
OP.2. 
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EXAMPLE: closing the INPUT file and putting the unit into manual. 


cxneanr @ cuecrmte Sree dae Lal 

_ : 

Seas iad reewwe LLLTIITLI 
ume | mae ° swiwiwes H 
an nae he us 
follo LAUT) [ui 
etal THY Las! ht 
elatol (Tt i | 
forejo] [! + H re 
jo!6|o| 1 
alo : Tr | C O 


NOTE: for an output file, it is necessary, before using the CLOSE macro 
instruction, to indicate whether the volume or the file is ta be 
closed, For volume close, the characters EQV are transferred to the 
first three positions of the WA (or the BA if the file consists of 
single-record blocks). For file close, the characters EOF are used. 


However, in case of end-of-file, if the characters EOF are not 


inserted in the first three locations of WA (or of BA), they will 
be automatically recorded by the CLOSE macro instruction. 
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IV. EXAMPLE 


Assume a card’ input file and three output files, two of which are on 
magnetic tape and one on the printer. 

The input file consists of two types of cards: with, respectively, card 
codes 50 and 51. The cards with code 50 make up™the records of the first 
tape, the blocks of which are formed by fixed-length logical elements. 
The cards with code 51 make up the records of a second tape, the blocks 
of which are formed by variable-length logical elements. The print file 
consists of records formed either by cards with codes other than 50 or 
51 or by those cards whose numeric fields do not result as’ such when an 
appropriate check is made. 


9 PROCESSING 


Figure 6 - BLOCK DIAGRAM FOR APS EXAMPLE 
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dM OUTPUT 


IF EWD-OF-FILE 
CLOSE CARD FILE CARD CODE 
£0? 
CARD CODE 
51? 


CLOSE PRINT FILE 
WRITE VARIABLE 
pees 


CLOSE TAPE FILES 
1 OUTPUT 


WRITE FIXED 
LENGTH RECORD 


PRINT CARD 


Figure 7 - FLOW CHART FOR APS EXAMPLE 
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ve. OPERATING STANDARDS 


A. ‘TRANSLATING THE SOURCE PROGRAM 


To translate the APS source program, the assembly program uses two work 
tapes, WI1 and WI2, mounted on any two tape units indicated on the .INT 
order card. 


The source program can be punched on cards or written on WI1. The 
assembly program is written on the System Tape, which can be mounted 
on any tape indicated in Pilot 0 (the supervisor's loading program). 
The object program is recorded on WT2. 


The assembly program is called in store by reading the order card with 
identification code.APS. When translating a program, therefore, the 
«APS card mist be the first one placed on the card reader. It is the 
only card if the source program is on magnetic tape (WI1). If the. 
source program is punched on cards, the .APS card must be followed by 
the source program cards. The source program must always start with 

the STRT card, be followed by the FILE cards, and end with the END card. 


After translation, the object program must be inserted in the System 
Tape by the .API order card. If the program is a subroutine, it is 
inserted in the Library by the .SLI order card. 

The ETOS manual (see Appendix B) describes the -API and .SLI orders. 
After translation, the assembly program supplies a printout giving all 


the source program instructions together with the corresponding object 
program instructions. 
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During translation, the validity of the source program instructions is 
checked. If there is an error, an appropriate signal is printed beside 

the incorrect instruction. A list of all the possible signals and a list 

of assembler messages appear on pages 194-199 and pages 200-201, respectively. 


The layout of the .APS order card is as follows: 


columns 1-4 “identification code: APS 

column 5 source program medium: 
. Bb if program is punched on cards eC 
. 2, if program is written on tape (WT) 


colum 6 source program: 


. 5 if it is a program 
» 1, if it is a subroutine 


columns © 7+14 name of program re) 


columns 15-49 program description, printed as the heading of 
the translated program's tabulation 


columns 50-72 not used 


columns 73-80 serial code, if needed. 
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EXQGUIING THE OBJECT PROGRAM 


To be executed, a user's program must previously have been inserted 
in the System Tape by the order .API. The program is called in store 
and started by the order .PRL if it is on the System Tape or if it 
is the first program on the Master Tape. The Master Tape programs 
following the first program are called in store and started by the 
Monitor routine of the preceding program. 


To make changes in the files table or checks on the tape files, LBC 
(Label Control) cards mst be used during program execution. If the 
program to be executed is on System Tape, the .PRL order card must 
be followed by the LBC card and then by the END card. If the 
program to Le executed is on Master Tape, the LBC cards are not 
necessary at program start if they were inserted when the Master 
Tape was, being generated. 
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c. CHECK AND ERROR _NESSAGES 


1. 


Assembler Signals 


During translation, the assembler checks the source program 
for formal validity. 


One of the following errer signals may result from this check. 
The signals are printed beside the incorrect statement. 


a. Checks on input/output macro instructions 


Eu MEANING OF SIGNAL ASSEMBLER BEHAVIOUR 


Operand incorrect The nacro instruction is 
not translated. 


Translation of the macro is * 
instruction would exceed 
the maxinum limit of the 


common-names table(ENTRY 
table) 


4n undefined file or a 
file defined with an 
incorrect FILE is 
indicated as operand 


194 


Checks on program instructions 


SIGNAL MEANING OF SIGNAL 


Double definition of an 
area or a constant whose 
name has been declared in 
an ENTRY instruction 


Superfluous declaration 


of a name in an ENTRY, 
that is, a name has 
been dedlared (e.g. the 
name of a subroutine) 
which the assembler 


automatically inserts 
in the common-names 
table 


Formal error in 
indicating operands 
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ASSEMBLER BEHAVIOUR 


The instruction is 
translated in the usual 
way and the same address 
is given to the two arear 
or constants} if..the 
addresses are different, 
the one associated with 
‘the first area or 
constant defined is 
valid. 


‘fhe declaration causes 
no problem and the 
instruction is transla~ 
ted in the usual way 


If the instruction is a 
DC it is not translated; 
otherwise it is transla- 
ted with other HLIMOA00) 
instructions 
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MEANING OF SIGNAL ASSEMBLER BEHAVIOUR 


Operand substantially 
incorrect 


SIGNAL 


If the error is in the 
STRT, the assembler 
assigns to. the program 
a STRT with operands 
2660,4. 

If the error is in a DC, 
the DC is translated 
with B if it is type C 
and with decimal zero 
if type X. If it appears 
ina IS, the IS is not 
translated; if the error 
appears in another 
instruction, the 
instruction is transla- 
ted with three ILI 
instructions (9409) 


Length error in the 
operands of a primary 
instruction or of an 
arithmetic macro 

instruction 


The instruction is 
translated tut the 
operand length will be 
incorrect 


The instruction is 
translated in the usual 
way 


The address counter has 
a value less than the 

minimum or greater than 
the maximum allowed 


Instruction name 
incorrect 


The instruction is 
translated but the name 
is not defined 
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MEANING OF SIGNAL 


Operation code incorrect 


Parity error: an 
instruction's function 
code is at an odd 
address 


A name defined more 
than once in the same 
section has been used 
as the operand of an 
instruction 


Sequence error, or 
program code is 
different from that of 
previous card 


Name not defined 
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ASSEMBLER BEHAVIOUR 


The instruction is 
translated with three 
HLT instructions (0400) 


The instruction is 
translated increasing 
its address by one 


The instruction is 
translated, but in those 
instructions in which 
the name is used as 
operand, the name itself 
is always translated 
with a single address 


The instruction is 
translated in the usual 
way 


The instruction is 
translated by assigning 
the hexadecimal values 
00 and 0000 to the 
length and address of the 
name 
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c. Checks on FILE declarative instructions 


SIGNAL MEANING OF SIGNAL ASSEMBLER BEHAVIOUR 


Formal error of any type The instruction is not 
translated 


Files with unnumbered blocks 
and records with length less! 
than 20 oO 


Piles with numbered blocks 
and records with length less 
than 15 


Incompatibility between type 

of tape and type of control; *) 
RM hes been defined = 8 and 

EP 


Incompatibility between type 

of tape and registration 

density; RM has been defined 

= 8 and PK # 8 or P r*) 


Incompatibility between type oO 
of tape and registration 

density; RM has been defined 

= 6 and PK = P 


Variable-length records have 
been defined with parameter 
RC>1023 
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SIGNAL MEANING OF SIGNAL ASSEMBLER BEHAVIOUR 


Length of block area is less |The instruction is translated 
than 80 characters (BK < 80) 


Length of block area (para- 
meter BK) exceeds maximum 

provided for by EIOS (equal 
to 27,000 positions) 


For files with numbered 
blocks and fixed-length 
records, the length of the 
block area has not been 

defined as the multiple of 
the length of: the work area 
+5 [BK # n(Ro+5)] 


For files with unmumbered 
blocks and fixed-length 
records, the length of the 
block area has not been 
defined asthe multiple of 
the length of the work area 
(BK # n.RG) 
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Under certain conditions, the assembly program issues the 


following messages: 


2401 =* UNIT X: PERSISTENT 
ERROR, 


2402 «* UNIT X: QUT OF 
ORDER 


2450 * TRANSLATION TYPE 
WRONG 
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Persistent error on unit with 
logical number X.. 

Program execution halts at 
addresa 0246; GO/NO GO 
condition: NO. 


Unit out of order. 

If there is an out-of-order 
condition after a rewind 
command, the program stops 
on a wait HLT at address O1DA. 
The opgratén-can restart the 
unit and press START. 

If the condition occurs after 
a read or write instruction, 
the program halts at address 
0246 with GO/NO GO condition: 
WO. 


If it takes place in a final 
rewind operation, the program 
terminates in the usual way. 


Column 5 or column 6 of the 
order card regarding a 
program translation contains 
an invalid character. 
Program execution stops at 
address 0246. GO/NO GO 
condition: NO. 


2451 


2452 


2453 


2454 


2498 


2499, 


* 


SUBROUTINE TYPE WRONG 


INVALID STRT CARD 


INVALID APS 
TRANSLATION 


INVALID SUBROUTINE 
TRANSLATION 


END OF SUBROUTINE 
TRANSLATION 


END OF APS 
TRANSLATION 
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Column 5 or column 6 of the 
order card regarding a 
subroutine translation contains 
an invalid character. 

Program execution halts at 
address 02A6. GO/NO Gd 
condition: NO. 


The STRT program card is 
incorrect or missing. 
Program execution halts at 
address 0246. CO/NO G9 
conditions NO. 


The translation is ended but the 
program contains errors. 

Program execution halts at 
address 0246. G0/NO Go 
condition: NO. 


The translation is ended but 
the subroutine contains errors. 
Program execution halts at 
address 0246. GO/NO 69 
condition: NO. 


The subroutine translation is 
ended. The order has been 
executed ‘correttly. 


The program translation is 
ended. The order has been 
executed correctly. 
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3. List of Halta Executed by HLT Instructions 


HLT address MEANING OF HL? ACTION TAKEN BY 
OPERATOR 


Signals that a check~ 
point has been written 


This halt occurs if the 

programmer has not of 5 more read or write 
provided the OF routine fattemps. 

for checking errors. 

It signifies persistent 

error at input or output. 


Unit out of service. 
This hait takes place 
if the programmer has 
not provided the OF 
routine for checking 
errors. 


Checking error in block [Press START for a new 
mumber during input. read attempt. 

This halt occurs if the 

programmer has not 

provided the OB routine 

for checking errors. 
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HLT address 


MEANING OF HLT 


- Unit out of service 
- read error 
- write error 


Thie halt occurs during 
file opening or during 
execution of a check- 
point. 


This HLT occurs during 
file opening. 

It can have one of the 
following meanings: 


- the first tape label 


is not INM (or VOL1) 


=the second tape label 
is not the HDR1 


- after the HIRI, the 
™ is not present. 


One of the comparisons 
made between the 
information on the HIR1 
label and that in the 
files table has given 
a@ negative result. 
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ACTION TAKEN BY 
OPERATOR 


- If during file opening, 
press START to restart 
file opening. 


- If during checkpoint 
execution, press START 
to attempt reading 
or writing again. 


Mount the correct tape 
and press START. 


Mount the correct tape 
and press START. 

Or, to continue, turn 
on SWITGH 2 and press 
START. 

In this case, the 
program stops on a wait 
HLT. At this point, turn 
SWITCH 2 off and press 
START again. 


HL? ADDRESS MEANING OF HLT 


An OPEN macro instructio 
has been commanded on a 
file already "open." 


A NEXT macro instruction 
has been commanded on a 
file that has not been 
"closed." 


A CLOSE macro instructio: 
has been commanded on a 
file already closed. 


A CEKP macro instruction 
has been commanded on a 
file that is not opened 
in output. 


Error in the final check 


of the blocks processed 
ina standard input file. 


There is a halt for 
reel, change. 
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ACTION TAKEN BY 
OPERATOR 


Press START to resume 


program execution from the| 
instruction immediately 
following the macro 
inatbuation wonaerned” | 
(which has no effect). 


To continue the check, 
press SWITCH 2 and press 
START. At this point the 
program again stops on a 
wait HLT. Therefore turn 
off SWITCH 2 and press 
START again. 


Mount new tape and press 
START. 
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PART VI - APPENDICES 


A. GLOSSARY 


ar 


Assembled Program 
Insert (.API) 


This order program follows the .APS order and 
permits an assembled program to be inserted in 
the ST. Also, whenever possible, it standardizes 
the length of program blocks to 4096 characters. 


Binary Numbers A numbering system using a base of two digits or 
"bits" (0 and 1) as compared to the decimal 


system Which uses a base of ten digits (0 to 9). 


An item of information normally treated as an 
entity by hardware (physical record). 

On magnetic tapes, a series of characters that 
are read or recorded during a single data 
transfer operation. 

Each block is followed by an inter-block (or 
inter-record) gap set to binary zero. 


Block Area Gore Store area used for temporary storage of a 


Block before and after processing. 


Block Number 


See "Block Sequence Number" 
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Block Sequence 
Nusnber 


Gard Read Area 


Connector 


Decimal Form 


End-of-Volume 
(zov1) 


End-of-Pile 
(20F1) 


File Code 


File Creation Date 


Header Label 


Identification 


Tecimal number (five digits in length) specifying 
the sequential order of a data block within a 
tape. Recorded in the first five characters of a 
numbered block. If not present, the block is 
called unnumbered. 


Field in System Reserved Area into which card 
contents are read. 


The GE 130 hae four outlets (connectors) to which 
the peripheral units are physically tied. The 
connectorva are switched electronically between 
1/0 channels, under Program dontrol. 


Representation of the digits 0 to 9 


See "Tape Trailer Label" 


See "File Trailer Label" 


See "File Identification Cote” 


Tate File was generated, recarded in File Header 
Label. 


An cu-character block of data identifying the 
beginning of a Standard File. Follows the Tape 
Header Label. 


Alphanumeric File identifier used within a 
program. (6 characters long). 


Alphanumeric File identifier recorded in the 
12-character field of the File Header Label. 
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= 


Pile Purge Date Date indicating the day after which the File can 
be deleted or updated, Recorded in File Header 
Label, 


File Retention Length of time during which the File must not be 
Period modified (expressed in number of days), 


File Table Table generated by the APS Assembler and 
containing the characteristics of the file(s) 
required by a program. It is recorded just 
before associated program, 


File Trailer Label An 80-character block of data identifying the 

(BOF1) end of a Standard Data File and the end of a 
tape. It contains the quantity of blocks in 
the File, 


File, Standard File containing standard blocks, standard 
Reader (¥OL1 or INT, and HDR1) and Trailer 
Labels (£0V1 or EOF1) and Tape Marks (TM's). 


GO/NO GO Condition See "ID Sequence Validity Switch". 


Hexadecimal + Conventional notation for designating the 16 
possible bit configurations of a quartet. 
Hexadecimal values are: 0, 1, 2, 3, 45 55 6; 
1, 8, 9, A, B, CO, D, Band Fy 


» This notation can be used in card punching 
to introduce in Core Store any quartet 
‘configuration: one hexa. character per 
column, two hexa, characters per octet, This 
is commonly referred to as "punching in 
hexadecimal" 


Abbreviation for hexadecimal, 
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ID Sequence 
Code 


ID Sequence 
Validity 
Switch 


Tllegal 


Index 
Register (or 
Regi sters) 


Initialize 
(.INP) 


1/0 Channels 
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DEFINITION 


Alternatively, a graphic {rather than a hexadecimal) 
character having a right quartet configuration in 
Core Store equal to the desired configuration can be 
used, These cards are said to be punched in "pure 
hexadecimal." (See GE 100 Graphic Character Set in 
GE 130 Reference Manual, Appendix B.) 


This code is used to identify a sequence of Order 
Cards being used to perform a series of inter-related 
operations. 


Octet in System Reserved Area which is tested for 
the correct or incorrect execution of a program 


Refers to an item of information which is not 
accepted as a valid representation by the machine 
design or by a specific routine or program. 


Special purpose two-octet fields in Core Store 
normally used for address modification. Eight 
registers, numbered from 0 to 7, are available. 


This order program performs the initial operations 
to start the System. 


Input/Output Channels, The electronic data paths 
used for tying peripheral units to the CPU, 
allowing independent and simultaneous transfer 
of information. The GE 130 has three channels. 
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Languages, APS 115 


Library Tape (LT) 


Loop 


Master Tape (MT) 


Monitor 


Order Cards 


The 115 software includes three APS versions: 
Basic APS, which is a one-to-one assembly 
program; Extended APS, which is an expansion of 
Basic APS as it provides some macro instructions; 
APS II which is designed to be run under the 
supervision of the Tape Operating System (T0S) 
or Dise Operating System (DOS). 


These cards are used to update the File Tables 
associated with the Data Files required by the 
User Programs. 


This.tape contains all the User (and Utility) 
Programs in working order. However, since it does 
not contain the BTOS programs it cannot be used 
for executing User Programs. 


See "VFU (Vertical Format Unit)" 


This tape contains all User and ETOS programs 
needed for operations during a specific working 
period (shift, day, week). The programs 
contained in this tape have been debugged and 
are arranged in proper sequence for carrying out 
the planned schedule of operations. 


Last segment of each progrem on MT and used to 
load and start the next program to be executed. 


The basic unit of information in the GE 130 
System, composed of eight binary digits (bits). 


Cards selected by the user for calling specific 
Order Programs. 
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Programe called by Order Cards for carrying out 
the ETOS functions, such as: Initialization, 
Translation, Debugging, Program Tape Generation 
and Maintenance, 


Packed Mode Generally denotes the packing of two decimal 
{also "Form"') digits in a single octet. 


Parity Bit A check bit that indicates whether the total 
number of "1" bits in a character or octet 
(including the parity bit) is odd or even. If 
the total number of "1" bite is always even, 
the system uses parity; if odd, it uses 
disparity. 


Program Garé A punched card containing program instructions. 

Program Code See "Program Identification Code" 

Program Alphanumeric program identifier (four 

Identification Code Charactera in length) specified ina 
Program card. 

Progran load This order program calls a program which 

(PRL) searches for, loads into Core Store, and starts 
a user's program located in the Sf or MT. 

Program Tape See "Tape, Program" 

Quartet Half an octet 

Record Group of characters normally treated as an entit: 
by the program (Logical Record), One or more 


Records in a Block. 


See "Tape" 
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Restart (.RST) 


This order program is used to resume a given 
program from a pre-determined point.The restart 
point (checkpoint) ie requested by the CHKP macro 
instruction and recorded on any standard file. 


Status Indicators 
(UF/OF and 2E/NZ) 


The Arithmetic Control Unit, which ia the 
internal processing instrument of the Gentral 
Processing Unit, can generate resulta of a 
qualitative nature. The qualitative resulta 
generated during tlie execution of each 
instruction are recorded in the status indicators,| 
two one-bit registera:. Underflow/Overflow (UF/OF) 
and Zero/ton~zero (ZB/NZ). The values of these 
indicators can be tested by the jump instructions 
in order to introduce variants into the program. 


Store Assignment 
Counter 


Core Store area, used by the APS Assembler to 
asgign store addresaes. during allocation of Core 
Store areas to data fields, constants, and 

instructions. 


Subroutine Library 


This order progrem ie used to insert a eubroutine 
Insert (.SLI) 


(which has gust been assembled on a WI by the 
-APS order) into the Subroutine Library on the 
ov. 


The controlling part of ETOS,since it links 
the various phases of work, performs the 

physical Input/Output operations, and processes 
the Order programs. 


Symbolic Name of 
File 


See "Pile Identification Code" 


au 


System Reserved 


System Tape (ST) 


Tape External Name 


Tape Header Label 
(Volume or Reel), 
(VOL1 for 9-track 
tape, INT1 for 7- 
track tape) 


Tape Mark (T™) 


Tape,Progran 


|, Tape Recording 
Density 


Tape Sequence 
Number (Yolume or 
Reel) 
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Reserved area in Core Store which includes: 
Supervisor, Data required by user programa, Data 
required by Order programs, HLT instructions 
(where programe stop as a result of condition 
checking), Instructions for calling BTOS and 
other standard routines. 


The basic Program Tape containing the complete 
software system, The LI and M? are derived from 
it, either directly or indirectly. It is made 
up of: Supervisor, Order Programs, Subroutine 
Library, Utility Programs, User Programs, 


See "Tape Unit Select Number" 


An 60-character block of data indicating the 
beginning cf a atandard tape. 


A special one-character block recognized by 
hardware and used as a program separator and at 
both ends of a standard tape. 


Standard Tape containing programs (ST, MT or 
UP). 


The number of 6—- or & bit characters that can 
be stored in one inch of tape» 


Sequence number of tape within a File. Four 
digits long. 
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Tape Serial Number 
(Volume or Reel) 


Alphanumeric tape identifier recorded in Tape 
Header Label (VOL1 or INT1). Six characters long. 


Tape, Standard 


See "File, Standard" 


Tape Trailer Label An 80-character block of data indicating the end 
{Volume or Reel) of a standard tape. Designated by name, "OVI". 
(for Data Files) It contains the quantity of blocks in the volume. 


Tape Unit Controller identifier contained in Tape Unit Name. 


Controller Name Pixed value, depending on peripheral configuration} 
Tape Unit Name Used by PER or PERI Instructions to address a 
tape unit. Fixed one-octet value, depending on 
peripheral configuration. 


Tape Unit Select 
Number 


Number assigned by the operator to a tape unit. 


Unpacked Mode Denotes the use of the right quartet only of an 
(also "Form") octet to store a decimal digit. 
It can also apply to binary numbers. 


VFU (Vertical The Vertical Format Unit, also called the VFU 
Format Unit) loop, is located under a cover at the right of 
the printer. The loop is an eight-track tape of 
metallized Mylar, with sprocket holes running 
the length of the tape, between tracks 3 and 4, 
for moving the tape. 


Volume See "Tape" 


Work Area Core Store area used for temporary storage of 
one Record before and after processing. 


Work Tape (WT) Tape used for intermediate storage of data files 
or programs. 
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B. PREREQUIS (VE AND RELATED READING 


COBOL Manual To be assigned 


ET0S Operator's Manual To be assigned oO 
ETOS Programmer's Manual To be assigned 

FORTRAN Manuel To be assigned 

Reference Manual CPB-1896 

SPG Manual To be assigned ° 


Subroutine, Vols 1 and 2 To be assigned 


Codes: P Prerequisite Reading oO 
R Related Reading Co 


A Analysts, Programmers 
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CG. COMPATIBILITY WITH THE GE 115 


The GE 115 and GE 130 computers belong to the 100 Series and are 
compatible+ 


Compatibility means that a 115 program written in Hasic APS, 
Extended APS cr APS II can be used on the GE 130 with no 

significant medifications. Compatibility can be realized at two 
different levels; during the translation phase of a 115 source 
program or during the execution phase of a 115 object program. in 
the first case, the source program mist be translated by the 130 APS 
assembler. In the second case, the 115 object program simply has to 
be inserted on a 130 Master Tape. 


During the translation phase of a 115 source program by means of the 
130 APS assembler, the following mast be kept in mind: 


For programs written in Extended APS: 


1) eliminate the PROG and DHP cards from the source program. 
The PROG card information is contained in the -APS ‘order 
card, while the DIP cards have no value for programs 
controlled by ETOS due to the different file opening 
procedure. 


2) insert the OPEN instructions for the magnetic tape files. 

3) the files mst have standard organization. 

4) the STRT instruction must have a start address not less 
than 2400 or 2600, depending on whether a Hollerith or a 


Bull reader is connected to the system 1n which the 
program is to be executed. 
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5) so that the object program can use the Operating System's 
te input/output routines included in the 2400 or 2600 
reserved area positions, all the magnetic tape file 
operations nust be carried out by the OPEN, GET, PUT, NEXT and 
CLOSE macro instructions and the card read and print 
operations nust be executed by the *LBSS macro instruction. 


6) if there is a rerun, it should be programmed by the CHKP 
macro instruction. 


Por prograne avitben in APS Tf: 
the information in point 4 applies. 
For programs written in Basic APS: 


the information in point 4 applies as well as that in point 5 
regarding the card read and print onerations. 


In order to translate a GB.115 source program using all 16,384 
store positions, it is necessary to make certain that the 
extension of the Operating System's reserved area does not render 
the store capacity insufficient (assuming that the program is 
truaslated and used in a 130 system with a capacity of 16,384 
positions). 


The APS 130 program translates the 115 source program into a 130 
object program and writes it on the work tape. The object program 
is then inserted on the System Tape in the normal way by means of 
the .API order card. 
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The 130 assembler is called by the .APS order card, which has the 
following layout: 


columns 1-4 identification code: .APS 
colum 5 source program language 
~ B if the GE 115 source program is card= 
punched in APS II or Basic APS 
- 1, if the GE 115 source program is card= 
punched in Extended APS 
- 2, if the GE 115 APS II source program is 
written on tape (WI) 


colum 6 type of source program: 


- z if it is a program 
- 1, if it is a subroutine 


columns 7 = 14 program name 


columns 15 ~ 49 program description, which will be printed 
as the hesding of the translated program's 
printout 


columns 50 - 72 not used 


columns 73 = 80 serial code, if required. 


The operating standards used for translation are those described on 
page 191 of this manual. 


During a program's execution phase, the supervisor can control both 


130 and 115 programs (written on the 130 System's Master Tape) 
because of the possibility of using BIOS 130 or BIOS 115. 


217 


APS REFERENCE MANUAL 


0 


115 programs are inserted on the 130 Master Tape by: 


I) creating a temporary 30Library Tape from a 115 Library 
Tape 


II) setting up a new 130 Library Tape (with 115 and 130 
programs) using the temporary 130 Library Tape and the 
already existing 130 Library Tape (with 130 programs only) 


III) setting up a 130 Master Tape from the new Library Tape. 


I TEMPORAR} gC 
130LT 
TEMPORAR) 
130LT 
; ) 
ml 


Programs from the 115 Library Tape are inserted on the 130 Master 
Tape by using appropriate order programs. 
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SUMMARY TABLES 


See overleaf the following tables: 
JUMP INSTRUCTIONS USED TO TEST QUALITATIVE RESULTS 
GENERATED BY OTHER OPERATIONS 


POSSIBLE CONFIGURATIONS OF PERIPHERAL UNIT NAMES 
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POSSIBLE CONFIGURATIONS OF PERIPHERAL UNIT NAMES 


PERIPHERAL UNIT NANES 


BINARY VALUES © HEXADEC IMAL 
VALUES 
peripheral unit 
i ifi identifier 


CONNECTOR 3. 


CONNECTOR 4 


NOTE: 


1. The names of peripheral units are represented by possible 
configurations of octet bits. The hexadecimal representation 
ef these configurations will be the value to attritute to the 
first operand of the PER instruction. 


2. The two most significant bits of the octet identify the 
connector. The other six bits refer to the peripheral units. 


3. The 6-bit peripheral unit identifier relative to connectors 1 
_and 2 contains a fixed configuration (00 0000). 
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4. The 6-bit peripheral unit identifier relative to connectors 
3 and 4 contains one of 64 possible configurations. 


wy 
we 
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B. DATA FILE ORGANIZATION 


1. Magnetic Tape Files 


ae Information format 


Tane information is written in blocks (or physical 
elements). Une or more records (or logical elements) 
em: be iucludte:t in a block. 


& record is information grouped logether by a common 
logical reference (t sxomple, 211 the information 
relative to a spor material present in a warehouse 
or to a speci. la that has been made). The record, 
therefore, in the Liiete logical processing unit since 
one record at a time is examined during processing. 


The block, on the o 
unit, since the physi 


* hand, ig the physical processing 
| read and write operations 
concern the whole Ulock ani not an individual record. 


For blocks consisting of a single record (single-record 
blocks} the logical] ani physical processing units 
coincide. 


The records and blocks can be of fixed or variable 

length. If a data file consists of fixed-length records, 
it is said to hve J. (fixed length) organization; if 
it consists of variable length records, it has a YL 
(variable length) organization; if it is made up of 
single-record blocks, it has a UN (unblocked) organization. 


The length of all the records, in-an. Fi: fileis. identical 
while each record has its own length in a VL file. 


The first two charactcrs of each record are used to write 
the length, in binary, in a file with a VL organization. 
If the value to be written is not greater than 255, the 
four least significant bits of the second and first 
characters are used, in that order. (The bits of the 
second character are the least significant.) 
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If the length is greater than 255, the fifth and sixth 
bits of the first character are also used. Therefore, 

the maximum length of a record is 1,023 characters in files 
with a VL organization. 


If the maximum record length is not greater than 255 
characters, the left quartet of the two characters 
containing the length must be prepared by the user. 
Otherwise, the left quartet of the first character is 
automatically arranged by the write subroutine according 
to the following criteria: 


value of bits 5 and 6 = 00 - left quartet 4 
" " wom 2 OF " " 
=10- 


a " wom 44 a " 


Gm 


In files with an FL organization the only limit to the 
length of the record depends on the block's maximum 
length. The blocks have a length varying from a minimum of 
20 characters to a maximum limited only by store 

capacity. The first five characters of each block are 
normally reserved for the block number; however, files 
with unnumbered blocks can also be processed. 


File organization 


A file can be contained on a single reel (volume)or on 
several reels. The first is a single-volume and the second 
@ multi-volume file. More than one file, however, cannot 
‘be present on the same volume. 


Bach volume begins with a tape- header label followed by 
a file header label. The first label contains information 
about the physical medium and, once written, usually _ 
remains unaltered. The second label contains information 
about the file and is, therefore, altered each time the 
file is updated. 
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After the two header labels, a one-character block called 
Tape Mark (TM) is written; it has a hexadecimal value of 
4¥ for 7-track tapes and 13 for 9-track tapes. The file 
blocks follow this block. 


The end of the file, or the end of that part of the file 
written on a volume, is indicated by a tape mark and a traiter 
label. The first characters of this label are EOF for end-of 
file and EOQV for end-of-volume. 


For software requirements, the minimum length of a 

record mst be 20 characters if the file blocks are 
unnumbered and 15 characters if the blocks are numbered. 
Moreover, in the definition of FILE macro instructions, 
the block area mst not be less than 80 and the work 

area not less than 20 or 15 positions in length, depending 
on whether or not the tape blocks are numbered. 


As well as indicating end-of-file or end-of-volume, the 
trailer label elso checks the number of blocks. It contains 
the block-counter field where the number of blocks present 
in the Volume is written. 


The end-of-file and end-of-volume labels are followed by 
‘two tape marks. All the labels are made up of 80 
alphanumeric characters. 


Tape labels 
The tape header label has the following format: 


Characters 7-4 Label name: VOL1 for 9-track tapes 
INM for 7-track tapes 
bs 5-10 Volume serial number 
" 11 - 41 Not used 
ia 42-51 User's name 
iD 52 - 80 Not used. - 
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The end-of-—volume label has the following format: 


Characters 1 - 4 


d. File labels 


Label name: FOY1 (end-of-volume) 


5~ 21. File name 
22-27 File serial number 
28 - 31 Order number of the volume to 


which the label belongs within 
the file 


32 - 35 Order number of the file within 


the volume. Since multi-file 
volumes are not admitted, this 
number is always 0001 


36 - 41 Blank 
42~- 47 File creation date, expressed in 


the form: }YYDDD 


48 - 53 File purge date, expressed in 


54 


the forn: JYYDDD 
Not used 


55 - 60 Block counter 
61 - 80 Blank. 


There are two types of file labels: HDR1, the file header 
label, and EOF1, the end-of-file label. 


Their Format is identical: 


Characters ‘1 — 


4 Label name: HDR] (start~of-file); 
BOF! (end~of-file) 


5-21 File name 
22 - 27 File serial number 


, 28 — 31 Order number of the volume to 


which the label belongs within 
the file 


32-35 Order number of the file within 


the volume. Since malti-File 
volumes are not admitted, this 
number is always 0001 . 
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Characters 36 - 41 Blan’: 

a 42-47 File creation date, exoressed 
in the form: #YYDDD 

“ 48 - 53 File purge date, expreased in 
the form: ¥YYDND 

au 54 Not used 

ny 55 - 60 Block counter significant only 
for the EOF! label 

am 61 ~ 80 . Blank. 


Card Files 


ae Information format 


The information is punched on 80-column cards with 
Hollerith or Bull coding. The logical and physical 
elements coincide. 


bd =«©Pile organization 


A file of card data must end with a card containing the 
characters $END in the first 4 colums. This card is not 
necessary if the card reader's EOF switch has been turned 
on, 


Print Files 
Print information can consist of characters to be printed and 
commands for paper movement or just the latter. 
ae Paper movement with printing 
In ‘this case the way in which the area that is to contain 
the print information (block area defined in the FILE 


macro instruction) is constituted depends on whether the 
file is made up of fixed or variable-length records. 


"> 
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For fixed-length records, the block . area consists of three 


areas: 


» the first area, starting from the left, consists of 
one store position and must contain the value zero 


+ the second area also consists of one store position 
and imat contain a paper movement code which can 
assume one of the following values (in hexadecimal); 


CO = no paper movement 


Qi = skip controlled by track 1 of VV 
“ 


02 = 
O-=. * " " 
4= 1 t " 
o= 8 " " 
6o=n " w 
j= " " n 
09 = single line feed 

QA = double line feed 

OB = triple line feed 

FF = set the unit to manual 


2 


4 AUMAY 


» the third area must contain the record to be printed, 
the length of which must not exceed 160 positions. 


For variable~length records, the block area consists of 


four areas: 


» the first area, starting from the left, consists 
. of one store position and must contain the value 
of the length of the record to be printed, 


increased by 2 


» the second area also consists of one store position 


and mst contain the value zero 


+ « the third area consiats of one position and must 
contain the paper movement code described above. 
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« the fourth area must contain the record to be 
printed, the length of which must not exceed 160 
positions. 


If the file consists of fixed-length records, the 
parameter BK of the FILE declarative instructions 
represents the actual length of the records to be 

printed increased by 2. If the file consists of 
variable-length records, the parameter BK represents the 
maximum length of the records to be printed increased by 3. 


Paper movement without printing 


In this case the block areca consists of two areas: 


» the first area, on the left, consists of one store 
position and must contain the value zero 


+ the second area also consist of one store position 


and ost contain the paper movement code described 
on page 232. 
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PL BAC LUP OF WIN APS ASS™OSLY PROGRAM 


the avS sssembler consists of 14 segments, cach of which has a specific 
faction: 
Segnent 1 
+ examination of .APS card 
« jaitial processing operations 
. STRY instruction check 
Segment 2 
« co-ordination among the various types of files for the 
execution of the FILE instructions 
Segments 3, 4, 5 
« formal examination and execution of the FILE instructions 
(setting up the files table) 
Segments 6, 7, 8 


+ formal examination and translation of the macro instructions 


Segment 9 


» calculation of the length of the subroutines to be assembled 
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oO 


Segment 10 


Subroutine Library Index 


Segment 11 
Formal examination and translation or execution of the 
instructions not using symbolic addresses, excluding the 
PILE instructions 

Segment 12 
Formal examination and translation or execution of the 
instructions using symbolic addresses, excluding the FILE 
instructions 


Segment 13 


Program assembly and report printout after translation 


Segment 14 


Subroutines assembled to main program. 
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INDEX 


ADDRESSES 
Absolute Addresses 
Field Symbolic Addresses 
Relative Addresses 


Symbolic Addresses with Increments or Decrements 


APS (ASSEMBLY PROGRAMMING SYSTEM) 
APS Language - Major Block Diagram 
Make-up of the APS Assembly Program 
.APS Order Card 

BIOS (BASIC INPUT/OUTPUT SYSTEM) 

BLOCK 

BLOCK COUNTER 

BLOCK NUMBER 

CHARACTERS OF THE GE 130 GRAPHIC SET 

CHECK END ERROR MESSAGES 

CHECKPOINT 

COMPATIBILITY WITH THE CE 115 


CONTROL CHARACTERS FOR THE EDT INSTRUCTION 


DATA FIELDS AND LENGTHS 
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28 
27 
30 
29 


5 
235 
192 


112 
224 
226 
225 

16 
194 
170 
215 

20 
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DATA PILES 
Close File 
Card 151 
Magnetic Tape 174 
Print 159 
Data File Organization * 224 
Card 231 
Magnetic Tape 224 
Priat 231 
Open File 
Cara 146 
Magnetic Tape 161 
Print 153 
EIOS (EXTENDED INPUT/OUTPUT SYSTEM) 135 
EIOS Macro Instructions 145 
Card Files Macro Instructions 145 
Print Files Mecro Instructions 152 
System Description 135 
Tape Files Macro Instructions 160 
FILE 
Ead—of-File Label 227 
File Header Label 227 
INDEX REGISTERS 37 
INDICATOR CONDITIONS 36 
INPUT/OUTPUT SYSTEMS 11 
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INSTRUCTION LIST 

Add Binary 

Add Decimal 

Add Memory to Register 

Add Packed 

Compare Complete Octets 
Compare Memory to Immediate 
Compare Packed 

Compare Right Quartets 
Compare Register to Memory 
Define Constant 

Define Peripheral Operation 
Define Store “3 
Divide Packed 


AB 
AD 


Bait 
Jump 


to Next Page 


End of Program 
Enable SINGLE~STOP 
Declare Names Common to Several Sections and Segments 45 
End of Section 
End of Segment 
Define Card Pile 
Define Print File 
Define Tape File 


Halt 


System Operation 


Inhibit SINGLE-STOP 


Jump 


on Condition 

on Condition and Return 

if Equal 

aif Equal and Return 

if Greater 

if Greater or Equal 

if Greater or Equal and Return 
if Greater and Return 

on Internal Error 

if Less 

if Less or Equal 

if Less or Equal and Return 
if Less and Return 

aif Not Equal 
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Jump if wot Equal and Return 88 

Samp Uuconditional and Return 89 

Jump if Switch 1 Set 88 

Jue Junp if Switch 2 Set 88 
a Jamp Unconditional 89 
LA Load Address 86 
Lr Line Feed 9 
LOFF Turn OPERATOR CALL Ligth Off 90 
10M Turn OPERATOR CALL Light On 90 
LFSR Lead Program Status Register 92 
LR Load Register 86 
“otriply Packed 81 

{ Jemplete Octects 83 
Immediate Octet 84 

ra Packed. 81 

.¢ Aight Quartets 8&1 

“And” on Complete Octets 83 

NT “and” on Immediate 84 
Bien No Jump 89 
Ne Jump and Return 89 

Bo Operation 90 

“Ox? on Somplete Octets 83 

"Oy" on Immediate 84 
Assign Origin Address 41 

Call Peripheral 91 

cai) Peripheral Indirect 92 

Pack Right Quartets into Octects 83 

Pack, with Sign 81 
Restart Origin Address 50 


Torset Binary 81 
ny Sult pact Decimal a1 
SL Search to the Left - 83 
ui Dutt: et Memory from Register 86 
BY Sabwract Packed a1 
SR Search to the Right 83 
fT? Stcre Register 86 
STRE Program Start 40 
™ Test Under Mask 84 
TR Translate 83 
UPK Unpack Octets into Right Quartets 83 
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UPKS 
xc 
aI 


* 


Unpack with Sign 

Exclusive "Or" on Complete Octets 
Exclusive "Or" on Immediate 
Comment 


INSTRUCTIONS 
Organization Instructions 
Declarative Instructions 
Directive Instructions 
List Control Instructions 
Primary Instructions 


HACRO INSTRUCTION LIST 


ABORT 
ADS 
CALL 
CHKP 
CLOSE 
CLOSE 
CLOSE 
DIVS 


Process Abort 

Call Subroutine YYADS 

Call Segment 

Store Checkpoint 

Close File on Card 

Close File on Printer 

Close Volome or File on Tape 
Call Subroutine YYDIVS 

Read Card 

Read Record 

Call Subroutine YYMULS 
Change Volume 

Open Card File 

Open Magnetic Tape Pile 
Open Print File 

Print Record 

Write Record 

Close Operation on Card Reader 
Close Operation on Printer 
Pass to New Block 

Call Subroutine YYSDS 

Paper Skip 

Stop Program and Restart Operating System 
Call Subroutine 

Call Subroutine 
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81 
83 
84 
17 


*LESS Read Cards and Print 
*MTAPE Operate Magnetic Tape Unit 
*N..N Command Peripheral Operation 


*N...N Call Subroutine with Parameters Definition 
*PRINT Print a Line and/or Advance Paper on Printer 


*READ Read a Card 


*TAPE Operate and Validate Magnetic Tape Unit 


*VCR Validate Card Reading 

*VNT Validate Tape Operation 

+FR Validate Printout 

*#N..N Validate Peripheral Operation 


MACRO INSTRUCTIONS 
Arithmetic Macro Instructions 
BIOS Macro Instructions 
Control Macro Instructions 
EIOS Macro Instructions 
Input/Output Subroutine Macro Instructions 


MINIMUM SYSTEM CONFIGURATION 


OBJECT PROGRAM 


‘. OPERANDS 


Immediate Operands 
Kinds of Operands 
Operand Specifications 
OPERATING STANDARDS 
_ OPERATION CODE 
PERIPHERAL UNIT NAMES 
PROGRAM CODE (PROGRAM IDENTIFICATION) 


PROGRAM IDENTIFICATION (PROGRAM CODE) 


PROGRAMMING FORM 
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123 
127 
140 
101 
418 
114 
133 
116 
131 
121 
442 


4104 
112 
5 
145 
136 
10 
193 
34 
25 
27 
191 
24 
37 
23 
23 
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RECORD 224 
RESERVED SYMBOLS OF THE APS LANGUAGE 15 
SEGHENTATION 6 
SINGLE-RECORD BLOCK 224 


SOURCE PROGRAM 


Composition of the Source Progran 12 

Translating the Source Program 194 
SYMBOLIC NAYE 24 
TAPE MARK (TI) 226 
VOLUIE 

End-of-Volume Label 227 

Tape Header Label 226 
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